GeoPrune

The GeoPrune node is used to show and hide objects in the scene or deactivate and active objects in the scene. Hide causes the specified objects to become invisible, whereas deactivate causes the specified objects to behave as though they haven't been added to the scene at all.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The previous stage in the scene you want to affect.

Control (UI)

Knob (Scripting)

Default Value

Function

GeoPrune

Mask

mask_patterns

{lastmodified}

Specifies the mask pattern to match the prim names to prune from the scene. The default mask, {lastmodified}, applies the prune to whatever was changed by the previous node. A simple way to think of it is that {lastmodified} affects the node above. You can use standard glob-style variables, such as /*, to create masks or use individual prim names separated by spaces. For example, /GeoCube 1 /GeoCard3 applies the prune effect to only those prims.

Tip:  You can also use the cog menu, the Viewer picker, or drag and drop paths from the Scene Graph to create masks.

Invert Selection

invert_mask

off

When turned off the prune method is only applied to the objects specified in the Mask control.

When turned on, the prune method is applied to all objects in the scene not specified in the Mask control.

Method

method

Hide

Sets the prune method to apply to objects:

Hide - hides the objects specified by the Mask pattern. Hidden objects behave as if they are invisible.

Show - shows the objects specified by the Mask pattern.

Deactivate - deactivates the objects specified by the Mask pattern. Deactivated objects behave as if they were never added to the scene.

Activate - Activates the objects specified by the Mask pattern. Activated objects behave normally.