A class to iterate over a contact pair extra data stream. More...

#include <PxSimulationEventCallback.h>

Collaboration diagram for PxContactPairExtraDataIterator:

[legend]

Public Member Functions
PX_FORCE_INLINE	PxContactPairExtraDataIterator (const PxU8 *stream, PxU32 size)
	Constructor. More...

PX_INLINE bool	nextItemSet ()
	Advances the iterator to next set of extra data items. More...

Public Attributes
const PxU8 *	currPtr
	Current pointer in the stream. More...

const PxU8 *	endPtr
	Pointer to the end of the stream. More...

const PxContactPairVelocity *	preSolverVelocity
	Pointer to the current pre solver velocity item in the stream. NULL if there is none. More...

const PxContactPairVelocity *	postSolverVelocity
	Pointer to the current post solver velocity item in the stream. NULL if there is none. More...

const PxContactPairPose *	eventPose
	Pointer to the current contact event pose item in the stream. NULL if there is none. More...

PxU32	contactPairIndex
	The contact pair index of the current item set in the stream. More...

Private Member Functions
PX_FORCE_INLINE void	clearDataPtrs ()
	Internal helper. More...

Detailed Description

A class to iterate over a contact pair extra data stream.

See also: PxContactPairHeader.extraDataStream

Constructor & Destructor Documentation

◆ PxContactPairExtraDataIterator()

PX_FORCE_INLINE PxContactPairExtraDataIterator::PxContactPairExtraDataIterator	(	const PxU8 *	stream,
		PxU32	size
	)

inline

Constructor.

Parameters

[in]	stream	Pointer to the start of the stream.
[in]	size	Size of the stream in bytes.

Member Function Documentation

◆ clearDataPtrs()

PX_FORCE_INLINE void PxContactPairExtraDataIterator::clearDataPtrs ( )

inlineprivate

Internal helper.

◆ nextItemSet()

PX_INLINE bool PxContactPairExtraDataIterator::nextItemSet ( )

inline

Advances the iterator to next set of extra data items.

The contact pair extra data stream contains sets of items as requested by the corresponding PxPairFlag flags PxPairFlag::ePRE_SOLVER_VELOCITY, PxPairFlag::ePOST_SOLVER_VELOCITY, PxPairFlag::eCONTACT_EVENT_POSE. A set can contain one item of each plus the PxContactPairIndex item. This method parses the stream and points the iterator member variables to the corresponding items of the current set, if they are available. If CCD is not enabled, you should only get one set of items. If CCD with multiple passes is enabled, you might get more than one item set.

Note: Even though contact pair extra data is requested per shape pair, you will not get an item set per shape pair but one per actor pair. If, for example, an actor has two shapes and both collide with another actor, then there will only be one item set (since it applies to both shape pairs).