Read Prims#

Reads primitives and outputs multiple primitive in a bundle.

Installation#

To use this Node, you must enable omni.graph.nodes in the Extension Manager.

Inputs#

Name

Type

Description

Default

Prims (prims)

target

This input acts differently based on whether ‘useFindPrims’ is true or false. If true, it is the exact prims to be read from. If false, the prims’ descendants will be searched against all patterns and read from if matched. If no prims are connected, absolute root / will be searched instead.

Use Find Prims (useFindPrims)

bool

When true, the ‘pathPattern’ and ‘typePattern’ attribute is used as the pattern to search for the prims to read otherwise it will read the connection at the ‘prim’ attribute.

False

Prim Path Pattern (pathPattern)

string

A list of wildcard patterns used to match the prim paths that are to be imported Supported syntax of wildcard pattern: ‘’*’’ - match an arbitrary number of any characters ‘?’ - match any single character ‘^’ - (caret) is used to define a pattern that is to be excluded Example of wildcard patterns, input: [‘/Cube0’, ‘/Cube1’, ‘/Box’] ‘’*’’ - match any ‘’*’ ^/Box’ - match any, but exclude ‘/Box’ ‘’*’ ^/Cube’*’’ - match any, but exclude ‘/Cube0’ and ‘/Cube1’

Prim Type Pattern (typePattern)

string

A list of wildcard patterns used to match the prim types that are to be imported Supported syntax of wildcard pattern: ‘’*’’ - match an arbitrary number of any characters ‘?’ - match any single character ‘^’ - (caret) is used to define a pattern that is to be excluded Example of wildcard patterns, input: [‘Mesh’, ‘Cone’, ‘Cube’] ‘’*’’ - match any ‘’*’ ^Mesh’ - match any, but exclude ‘Mesh’ ‘’*’ ^Cone ^Cube’ - match any, but exclude ‘Cone’ and ‘Cube’

Attribute Name Pattern (attrNamesToImport)

string

A list of wildcard patterns used to match the attribute names that are to be imported Supported syntax of wildcard pattern: ‘’*’’ - match an arbitrary number of any characters ‘?’ - match any single character ‘^’ - (caret) is used to define a pattern that is to be excluded Example of wildcard patterns, input: [‘points’, ‘faceVertexCount’, ‘faceVertexIndices’, ‘size’] ‘’*’’ - match any ‘’*’ ^points’ - match any, but exclude ‘points’ ‘’*’ ^face’*’’ - match any, but exclude ‘faceVertexCount’ and ‘faceVertexIndices’

Time (usdTimecode)

timecode

The time at which to evaluate the transform of the USD prim. A value of NaN indicates that the default USD time stamp should be used

NaN

Compute Bounding Box (computeBoundingBox)

bool

For each primitive compute local bounding box and store them as ‘bboxMinCorner’, ‘bboxMaxCorner’ and ‘bboxTransform’ attributes.

False

Apply Skel Binding (applySkelBinding)

bool

If an input USD prim is skinnable and has the SkelBindingAPI schema applied, read skeletal data and apply SkelBinding to deform the prim. The output bundle will have additional child bundles created to hold data for the skeleton and skel animation prims if present. After evaluation, deformed points and normals will be written to the points and normals attributes, while non-deformed points and normals will be copied to the points:default and normals:default attributes.

False

Outputs#

Name

Type

Description

Default

primsBundle

bundle

An output bundle containing multiple prims as children. Each child contains data attributes and two additional token attributes named sourcePrimPath and sourcePrimType which contains the path of the Prim being read