NVIDIA(R) PhysX(R) SDK 3.4 API Reference: PxContactModifyCallback Class Reference

NVIDIA PhysX SDK 3.4 API

PxContactModifyCallback Class Reference
[Physics]

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

#include <PxContactModifyCallback.h>

List of all members.


Public Member Functions

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

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 (  )  [inline, protected, virtual]


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:



Copyright © 2008-2017 NVIDIA Corporation, 2701 San Tomas Expressway, Santa Clara, CA 95050 U.S.A. All rights reserved. www.nvidia.com