PxConstraintConnector

class PxConstraintConnector

This class connects a custom constraint to the SDK.

This class connects a custom constraint to the SDK, and functions are called by the SDK to query the custom implementation for specific information to pass on to the application or inform the constraint when the application makes calls into the SDK which will update the custom constraint’s internal implementation

Subclassed by PxVehicleConstraintConnector

Public Functions

virtual void *prepareData() = 0: Pre-simulation data preparation when the constraint is marked dirty, this function is called at the start of the simulation step for the SDK to copy the constraint data block.

virtual bool updatePvdProperties(physx::pvdsdk::PvdDataStream &pvdConnection, const PxConstraint *c, PxPvdUpdateType::Enum updateType) const = 0: this function is called by the SDK to update PVD’s view of it

virtual void updateOmniPvdProperties() const = 0: this function is called by the SDK to update OmniPVD’s view of it

virtual void onConstraintRelease() = 0

Constraint release callback.

When the SDK deletes a PxConstraint object this function is called by the SDK. In general custom constraints should not be deleted directly by applications: rather, the constraint should respond to a release() request by calling PxConstraint::release(), then wait for this call to release its own resources.

This function is also called when a PxConstraint object is deleted on cleanup due to destruction of the PxPhysics object.

virtual void onComShift(PxU32 actor) = 0

Center-of-mass shift callback.

This function is called by the SDK when the CoM of one of the actors is moved. Since the API specifies constraint positions relative to actors, and the constraint shader functions are supplied with coordinates relative to bodies, some synchronization is usually required when the application moves an object’s center of mass.

virtual void onOriginShift(const PxVec3 &shift) = 0

Origin shift callback.

This function is called by the SDK when the scene origin gets shifted and allows to adjust custom data which contains world space transforms.