GeoDrawMode

The GeoDrawMode node sets the draw mode for objects with a Kind assigned, allowing you to display complicated geometry in a simplified form, such as a bounding box or crossed cards, to load scenes faster. It's also good practice to follow the conventions on the use of Kind to create properly-constructed USD stages if you intend to export the scene for use in your pipeline.

Note:  Draw mode only works on objects that have their Kind set. Objects with no Kind assigned are unaffected.

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

GeoDrawMode

Mask

mask_patterns

{lastmodified}

Specifies the mask pattern to match the prim names to affect. The default mask, {lastmodified}, applies the draw mode 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 transform 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.

Apply Draw Mode

apply_draw_mode

on

When enabled, any prims with a Kind set are drawn using the selected Draw Mode. Any prims with no Kind set are drawn as normal.
The selected prims are also assigned the model:applyDrawMode attribute when this control is enabled, which can be inherited by prims in subtrees.

When disabled, all prims are drawn as normal.

Draw Color

draw_mode_color

1, 0, 0

Sets the draw color of the replacement proxy prims.

Draw Mode

draw_mode

Default

When Apply Draw Mode is enabled, the specified prims are affected by the mode selected:

• Origin - the prims are replaced by a proxy origin indicator drawn in the selected Draw Color.

• Bounds - the prims are replaced by a proxy bounding box indicator drawn in the selected Draw Color.

• Cards - the prims are replaced by proxy cards drawn in the selected Draw Color. The appearance of the cards is determined by the Card Geometry and Texture XYZ controls.

• Default - the prims are drawn as normal, regardless of what Kind attribute they have set.

• Inherited - the prims inherit their Draw Mode from their parent prim.

Card Geometry

card_geometry

Cross

When Draw Mode is set to Card, determines how the proxy cards are drawn:

• Cross - two proxy cards replace the specified prims along the XYZ axes.

• Box - six proxy cards replace the specified prims a box shape.

Texture XYZ

card_texture_X_neg

none

Specifies files on disk as textures applied to the proxy cards and sets the texture's orientation on the card's XYZ axes.

Note:  The Texture controls are only available when Draw Mode is set to Card.

card_texture_X_pos

none

card_texture_Y_neg

none

card_texture_Y_pos

none

card_texture_Z_neg

none

card_texture_Z_pos

none