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

Default

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.