Overlap, Box, All#

Returns a list of prim paths of all colliders that overlap the input box.

It also provides you with the paths to the physics bodies that the colliders belong to.

Note

This node is based on PhysX Scene Queries, benefitting from the fast performance of PhysX collision detection, but it will only detect physics colliders and only when simulation is active.

Installation#

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

Inputs#

Name	Type	Description
execIn	`execution`	Input execution
Position (position)	`pointf[3]`, `pointd[3]`	Box center position.
Dimensions (dimensions)	`float[3]`, `double[3]`	Box dimensions
Rotation (rotation)	`float[3]`, `double[3]`	Box rotation in XYZ order Euler angles.

Outputs#

Name	Type	Description
execOut	`execution`	Output execution
Collider Prim paths (colliderPrimPaths)	`token[]`	A list of paths of the collider prims that overlap the input box.
bodyPrimPaths	`token[]`	A list of paths of the associated body prims for the collider prims that overlap the input box.

Note

The node has an execution in and out connecter to allow you to control exactly when in the graph execution chain that the scene query will be processed, thereby avoiding redundant executions. However, to guarantee that the output data is current, make sure that any other nodes reading it are later in the execution chain, i.e. belong to a node tree connected to the node execution out.

For examples of concrete use of scene query nodes within an ActionGraph, see the OmniGraph demos in the physics demo scenes under Scene Query.