PxCCDContactModifyCallback Class Referenceabstract

An interface class that the user can implement in order to modify CCD contact constraints. More...

#include <PxContactModifyCallback.h>

Public Member Functions

virtual void onCCDContactModify (PxContactModifyPair *const pairs, PxU32 count)=0
 Passes modifiable arrays of contacts to the application. More...
 

Protected Member Functions

virtual ~PxCCDContactModifyCallback ()
 

Detailed Description

An interface class that the user can implement in order to modify CCD contact constraints.

Threading: It is necessary to make this class thread safe as it will be called in the context of the simulation thread. It might also be necessary to make it reentrant, since some calls can be made by multi-threaded parts of the physics engine.

You can enable the use of this contact modification callback by raising the flag PxPairFlag::eMODIFY_CONTACTS in the filter shader/callback (see PxSimulationFilterShader) for a pair of rigid body objects.

Please note: + Raising the contact modification flag will not wake the actors up automatically. + It is not possible to turn off the performance degradation by simply removing the callback from the scene, the filter shader/callback has to be used to clear the contact modification flag. + The contacts will only be reported as long as the actors are awake. There will be no callbacks while the actors are sleeping.

See also
PxScene.setContactModifyCallback() PxScene.getContactModifyCallback()

Constructor & Destructor Documentation

◆ ~PxCCDContactModifyCallback()

virtual PxCCDContactModifyCallback::~PxCCDContactModifyCallback ( )
inlineprotectedvirtual

Member Function Documentation

◆ onCCDContactModify()

virtual void PxCCDContactModifyCallback::onCCDContactModify ( PxContactModifyPair *const  pairs,
PxU32  count 
)
pure virtual

Passes modifiable arrays of contacts to the application.

The initial contacts are as determined fresh each frame by collision detection.

The number of contacts can not be changed, so you cannot add your own contacts. You may however disable contacts using PxContactSet::ignore().

See also
PxContactModifyPair

The documentation for this class was generated from the following file: