list_elements
Returns scene elements of a subgraph originating at a given scene element. The method iterates over all elements of a subgraph originating at the given scene element and returns their names. Optionally, the results can be filtered by a regular expression for the element names and a list for type names. Note that the runtime of the method depends on the number of elements in the subgraph. It might be expensive to call this method for large subgraphs.
References:
arguments
- "include_defaults" : Boolean (default: true)
If true, MDL material instances and function calls which are used as default values will be included.
- "pattern" : String (default: null)
A regular expression that acts as filter on the names of returned scene elements. The regular expression must be compliant to extended regular expressions as defined in POSIX 1003.2.
- "root_element" : String
The root of the subgraph to traverse.
- "type_names" : String[] (default: null)
A list of type names that acts as filter on the names of returned scene elements. Only scene elements with a matching type name pass the filter. If this is omitted then all scene elements pass the filter irrespective of their type name.
return value
String[]An array containing the names of the elements.