Find Prims

Finds Prims on the stage which match the given criteria

Installation

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

Inputs

Name

Type

Description

Default

Prim Type Pattern (type)

token

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’

Prim Path Pattern (pathPattern)

token

A list of wildcard patterns used to match the prim paths 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’

Root Prim Path (rootPrimPath)

token

Only children of the given prim will be considered. Empty will search the whole stage.

Root Prim (rootPrim)

target

Only children of the given prim will be considered. If rootPrim is specified, rootPrimPath will be ignored.

Prim Name Prefix (namePrefix)

token

Only prims with a name starting with the given prefix will be returned.

Attribute Names (requiredAttributes)

string

A space-separated list of attribute names that are required to be present on matched prims

Relationship Name (requiredRelationship)

token

The name of a relationship which must have a target specified by requiredRelationshipTarget or requiredTarget

Relationship Prim Path (requiredRelationshipTarget)

path

The path that must be a target of the requiredRelationship

Relationship Prim (requiredTarget)

target

The target of the requiredRelationship

recursive

bool

False means only consider children of the root prim, True means all prims in the hierarchy

ignoreSystemPrims

bool

Ignore system prims such as omni graph nodes that shouldn’t be considered during the import.

False

Outputs

Name

Type

Description

Default

prims

target

A list of Prim paths which match the given type

primPaths

token[]

A list of Prim paths as tokens which match the given type