FilterResults
Searches an input scene for all locations matched by a filter.
Caution
This can be an arbitrarily expensive operation
depending on the size of the input scene and the filter
used. In particular it should be noted that the usage of
...
in a PathFilter will cause the entire input scene to
be searched even if there are no matches to be found.
user
Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.
scene
The scene to be searched for matching locations.
filter
The filter to be used when searching for matching locations.
root
Isolates the search to this location and its descendants.
out
The results of the search, as an IECore::PathMatcher
object. This
is most useful for performing hierarchical queries and for iterating
through the paths without an expensive conversion to strings.
outStrings
The results of the search, converted to a list of strings. This is
useful for connecting directly to other plugs, such as
Wedge.strings
or CollectScenes.rootNames
.