GeoActivation

The GeoActivation node allows you to activate or deactive a prim. The Invert Selection control is on by default.

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

GeoActivation

Mask

mask_patterns

Default - Injected/ All Roots

Specifies the mask pattern to match the prim names to affect.

You can use standard glob-style wildcards, such as '*', '?', to create masks or use individual prim names separated by spaces. For example, /GeoCube 1 /GeoCard3 applies the effect to only those prims.

Default - Injected/All Roots - selects the default prim(s) for the node. The default will be the injected mask prim paths if there is an upstream node with this. Otherwise the default mask for this node type is evaluated.

All roots - select the top level Xform(s) in your scene.

Last modified - selects whatever the last node modified was.

All Cameras - selects all Cameras in your scene graph.

All Lights - select all lights in your scene graph.

All Meshes - selects all meshes in your scene graph.

Custom - sets a custom selection of prims that exist in your scene graph.

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

Inject Mask inject_mask off When enabled the mask in this node is injected into the node directly below it if that node has the default path mask set.

Invert Selection

invert_mask

off

When on, the Mask path selection is inverted so that the specified objects are isolated from the incoming layer.

When off, the specified objects are not isolated.

Method

method

deactivate

Sets how the objects behave.

deactivate - the objects are temporarily disabled or turned off. Unlike hiding, a deactivated object is still considered during stage composition, but it is effectively inactive in the scene. This is commonly used to stop objects affecting a scene's behavior without removing them.

activate - the objects are reactivated if they were previously deactivated.