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.