Skip to main content

collider_active_events

Event handlers are user-defined callbacks used to be notified when two colliders start/stop touching. By default no collision event is generated by the narrow-phase. In order to enable a collision event for a pair of colliders, at least one of the involved colliders must have the corresponding event set as active. An event is activated for a collider by setting its corresponding active events bit to 1:

  • Setting the ActiveEvents::COLLISION_EVENTSActiveEvents.COLLISION_EVENTS bit to 1 enables the collision events involving the collider.

The active events of a collider can be set when the collider is created or after its creation:

<load path='/2d/rust/examples/rs_colliders2.rs' marker='ActiveEvents1' />
<load path='/2d/rust/examples/rs_colliders2.rs' marker='ActiveEvents2' />
 
<load path='/2d/bevy/examples/colliders2.rs' marker='ActiveEvents1' />
<load path='/2d/bevy/examples/colliders2.rs' marker='ActiveEvents2' />
 
<load path='/2d/javascript/src/snippets/colliders.ts' marker='ActiveEvents1' />
<load path='/2d/javascript/src/snippets/colliders.ts' marker='ActiveEvents2' />