PxFilterFlag

Defined in include/PxFiltering.h

struct PxFilterFlag

Collection of flags describing the filter actions to take for a collision pair.

Public Types

enum Enum

Values:

enumerator eKILL

Ignore the collision pair as long as the bounding volumes of the pair objects overlap.

Killed pairs will be ignored by the simulation and won’t run through the filter again until one of the following occurs:

  • The bounding volumes of the two objects overlap again (after being separated)

  • The user enforces a re-filtering (see PxScene::resetFiltering())

enumerator eSUPPRESS

Ignore the collision pair as long as the bounding volumes of the pair objects overlap or until filtering relevant data changes for one of the collision objects.

Suppressed pairs will be ignored by the simulation and won’t make another filter request until one of the following occurs:

  • Same conditions as for killed pairs (see eKILL)

  • The filter data or the filter object attributes change for one of the collision objects

enumerator eCALLBACK

Invoke the filter callback (PxSimulationFilterCallback::pairFound()) for this collision pair.

enumerator eNOTIFY

Track this collision pair with the filter callback mechanism.

When the bounding volumes of the collision pair lose contact, the filter callback PxSimulationFilterCallback::pairLost() will be invoked. Furthermore, the filter status of the collision pair can be adjusted through PxSimulationFilterCallback::statusChange() once per frame (until a pairLost() notification occurs).

enumerator eDEFAULT

Provided default to get standard behavior:

The application configure the pair’s collision properties once when bounding volume overlap is found and doesn’t get asked again about that pair until overlap status or filter properties changes, or re-filtering is requested.

No notification is provided when bounding volume overlap is lost

The pair will not be killed or suppressed, so collision detection will be processed