On Contact Event#

PhysX contact event triggered execution.

Allows triggering other ActionGraph nodes whenever two physics bodies either come, remain or cease to be in contact.

Note

This node is based on PhysX Contact Events. For contact between the input body prims and other prims to trigger, the following conditions must be met:

Both prims must be physics bodies with colliders.
At least one of the two must have the Contact Reporter API applied. Notice however that it does not have to be the physics body specified on the node that carries the API.
Simulation must be active.

Installation#

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

Inputs#

Name	Type	Description	Default
Body Paths (bodyPaths)	`token[]`	Body prim paths to check against.
Body Prims (targetBodies)	`bundle`	Body prims to check against.

Outputs#

Name	Type	Description
foundExecOut	`execution`	Output execution trigger for contact found events. Note that the node only evaluates and triggers for contact events where one of the bodies have the Contact Report API applied.
persistsExecOut	`execution`	Output execution trigger for contact persists events. Note that the node only evaluates and triggers for contact events where one of the bodies have the Contact Report API applied.
lostExecOut	`execution`	Output execution trigger for contact lost events. Note that the node only evaluates and triggers for contact events where one of the bodies have the Contact Report API applied.
Contacting Body (contactingBody)	`token`	Path of the physics body that came in contact with a node input body to trigger the contact event.
Input Body (inputBody)	`token`	Path of the node input physics body that triggered the contact event.

Note

The “input body” outputs will tell you which of the physics bodies input triggered the node execution. If you only specify a single physics body input, this will always also be the inputBody output.

For an example of concrete use of contact event nodes within an ActionGraph, see the OmniGraph demo in the physics demo scenes under Contacts.