PxContactModifyCallback Class Reference

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

#include <PxContactModifyCallback.h>

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

Protected Member Functions
virtual	~PxContactModifyCallback ()

Detailed Description

An interface class that the user can implement in order to modify 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

virtual PxContactModifyCallback::~PxContactModifyCallback ( )

inlineprotectedvirtual

Member Function Documentation

virtual void PxContactModifyCallback::onContactModify ( 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:

• PxContactModifyCallback.h