PathFilter
Chooses locations by matching them against a list of paths.
user
Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.
enabled
The on/off state of the filter. When it is off, the filter does not match any locations.
out
The result of the filter. This should be connected into the “filter” plug of a FilteredSceneProcessor.
paths
The list of paths to the locations to be matched by the filter.
A path is formed by a sequence of names separated by /
, and
specifies the hierarchical position of a location within the scene.
Paths may use Gaffer’s standard wildcard characters to match
multiple locations.
The *
wildcard matches any sequence of characters within
an individual name, but never matches across names separated
by a /
.
/robot/*Arm
matches/robot/leftArm
,/robot/rightArm
and/robot/Arm
. But does not match/robot/limbs/leftArm
or/robot/arm
.
The ...
wildcard matches any sequence of names, and can be
used to match locations no matter where they are parented in
the hierarchy.
/.../house
matches/house
,/street/house
and/city/street/house
.
roots
An optional filter input used to provide multiple root locations
which the paths
are relative to. This can be useful when working
on a single asset in isolation, and then placing it into multiple
locations within a layout. When no filter is connected, all paths
are treated as being relative to /
, the true scene root.