Class used to retrieve statistics for a simulation step. More...

#include <PxSimulationStatistics.h>

Public Types
enum	VolumeType { eRIGID_BODY, ePARTICLE_SYSTEM, eCLOTH, eVOLUME_COUNT }
	Identifies each type of broadphase volume. More...

enum	RbPairStatsType { eDISCRETE_CONTACT_PAIRS, eCCD_PAIRS, eMODIFIED_CONTACT_PAIRS, eTRIGGER_PAIRS }
	Different types of rigid body collision pair statistics. More...

Public Member Functions
PxU32	getNbBroadPhaseAdds (VolumeType type) const
	Get number of broadphase volumes of a certain type added for the current simulation step. More...

PxU32	getNbBroadPhaseRemoves (VolumeType type) const
	Get number of broadphase volumes of a certain type removed for the current simulation step. More...

PxU32	getRbPairStats (RbPairStatsType pairType, PxGeometryType::Enum g0, PxGeometryType::Enum g1) const
	Get number of shape collision pairs of a certain type processed for the current simulation step. More...

	PxSimulationStatistics ()

Public Attributes
PxU32	nbActiveConstraints
	Number of active PxConstraint objects (joints etc.) for the current simulation step. More...

PxU32	nbActiveDynamicBodies
	Number of active dynamic bodies for the current simulation step. More...

PxU32	nbActiveKinematicBodies
	Number of active kinematic bodies for the current simulation step. More...

PxU32	nbStaticBodies
	Number of static bodies for the current simulation step. More...

PxU32	nbDynamicBodies
	Number of dynamic bodies for the current simulation step. More...

PxU32	nbShapes [PxGeometryType::eGEOMETRY_COUNT]
	Number of shapes of each geometry type. More...

PxU32	nbAxisSolverConstraints
	The number of 1D axis constraints(joints+contact) present in the current simulation step. More...

PxU32	compressedContactSize
	The size (in bytes) of the compressed contact stream in the current simulation step. More...

PxU32	requiredContactConstraintMemory
	The total required size (in bytes) of the contact constraints in the current simulation step. More...

PxU32	peakConstraintMemory
	The peak amount of memory (in bytes) that was allocated for constraints (this includes joints) in the current simulation step. More...

PxU32	nbBroadPhaseAdds [eVOLUME_COUNT]

PxU32	nbBroadPhaseRemoves [eVOLUME_COUNT]

PxU32	nbDiscreteContactPairs [PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxU32	nbCCDPairs [PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxU32	nbModifiedContactPairs [PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxU32	nbTriggerPairs [PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxU32	totalDiscreteContactPairsAnyShape

PxU32	particlesGpuMeshCacheSize

PxU32	particlesGpuMeshCacheUsed

PxReal	particlesGpuMeshCacheHitrate

Detailed Description

Class used to retrieve statistics for a simulation step.

See Also: PxScene::getSimulationStatistics()

Member Enumeration Documentation

enum PxSimulationStatistics::RbPairStatsType

Different types of rigid body collision pair statistics.

See Also: getRbPairStats

Enumerator
eDISCRETE_CONTACT_PAIRS	Shape pairs processed as discrete contact pairs for the current simulation step.
eCCD_PAIRS	Shape pairs processed as swept integration pairs for the current simulation step. Note Counts the pairs for which special CCD (continuous collision detection) work was actually done and NOT the number of pairs which were configured for CCD. Furthermore, there can be multiple CCD passes and all processed pairs of all passes are summed up, hence the number can be larger than the amount of pairs which have been configured for CCD. See Also PxPairFlag::eDETECT_CCD_CONTACT,
eMODIFIED_CONTACT_PAIRS	Shape pairs processed with user contact modification enabled for the current simulation step. See Also PxContactModifyCallback
eTRIGGER_PAIRS	Trigger shape pairs processed for the current simulation step. See Also PxShapeFlag::eTRIGGER_SHAPE

enum PxSimulationStatistics::VolumeType

Identifies each type of broadphase volume.

See Also: nbBroadPhaseAdds nbBroadPhaseRemoves

Enumerator
eRIGID_BODY	A volume belonging to a rigid body object. See Also PxRigidStatic PxRigidDynamic PxArticulationLink
ePARTICLE_SYSTEM	A volume belonging to a particle system. See Also PxParticleSystem PxParticleFluid
eCLOTH	A volume belonging to a cloth. See Also PxCloth
eVOLUME_COUNT

Constructor & Destructor Documentation

PxSimulationStatistics::PxSimulationStatistics ( )

inline

References PxGeometryType::eGEOMETRY_COUNT.

Member Function Documentation

PxU32 PxSimulationStatistics::getNbBroadPhaseAdds ( VolumeType type ) const

inline

Get number of broadphase volumes of a certain type added for the current simulation step.

Parameters

[in] type The volume type for which to get the number

Returns: Number of broadphase volumes added.

See Also: VolumType

References PX_ASSERT.

PxU32 PxSimulationStatistics::getNbBroadPhaseRemoves ( VolumeType type ) const

inline

Get number of broadphase volumes of a certain type removed for the current simulation step.

Parameters

[in] type The volume type for which to get the number

Returns: Number of broadphase volumes removed.

See Also: VolumType

References PX_ASSERT.

PxU32 PxSimulationStatistics::getRbPairStats	(	RbPairStatsType	pairType,
		PxGeometryType::Enum	g0,
		PxGeometryType::Enum	g1
	)		const

inline

Get number of shape collision pairs of a certain type processed for the current simulation step.

There is an entry for each geometry pair type.

Note: entry[i][j] = entry[j][i], hence, if you want the sum of all pair types, you need to discard the symmetric entries

Parameters

[in]	pairType	The type of pair for which to get information
[in]	g0	The geometry type of one pair object
[in]	g1	The geometry type of the other pair object

Returns: Number of processed pairs of the specified geometry types.

References PxGeometryType::eGEOMETRY_COUNT, and PX_ASSERT.

Member Data Documentation

PxU32 PxSimulationStatistics::compressedContactSize

The size (in bytes) of the compressed contact stream in the current simulation step.

PxU32 PxSimulationStatistics::nbActiveConstraints

Number of active PxConstraint objects (joints etc.) for the current simulation step.

PxU32 PxSimulationStatistics::nbActiveDynamicBodies

Number of active dynamic bodies for the current simulation step.

Note: Does not include active kinematic bodies

PxU32 PxSimulationStatistics::nbActiveKinematicBodies

Number of active kinematic bodies for the current simulation step.

Note: Kinematic deactivation occurs at the end of the frame after the last call to PxRigidDynamic::setKinematicTarget() was called so kinematics that are deactivated in a given frame will be included by this counter.

PxU32 PxSimulationStatistics::nbAxisSolverConstraints

The number of 1D axis constraints(joints+contact) present in the current simulation step.

PxU32 PxSimulationStatistics::nbBroadPhaseAdds[eVOLUME_COUNT]

PxU32 PxSimulationStatistics::nbBroadPhaseRemoves[eVOLUME_COUNT]

PxU32 PxSimulationStatistics::nbCCDPairs[PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxU32 PxSimulationStatistics::nbDiscreteContactPairs[PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxU32 PxSimulationStatistics::nbDynamicBodies

Number of dynamic bodies for the current simulation step.

Note: Includes inactive and kinematic bodies, and articulation links

PxU32 PxSimulationStatistics::nbModifiedContactPairs[PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxU32 PxSimulationStatistics::nbShapes[PxGeometryType::eGEOMETRY_COUNT]

Number of shapes of each geometry type.

PxU32 PxSimulationStatistics::nbStaticBodies

Number of static bodies for the current simulation step.

PxU32 PxSimulationStatistics::nbTriggerPairs[PxGeometryType::eGEOMETRY_COUNT][PxGeometryType::eGEOMETRY_COUNT]

PxReal PxSimulationStatistics::particlesGpuMeshCacheHitrate

PxU32 PxSimulationStatistics::particlesGpuMeshCacheSize

PxU32 PxSimulationStatistics::particlesGpuMeshCacheUsed

PxU32 PxSimulationStatistics::peakConstraintMemory

The peak amount of memory (in bytes) that was allocated for constraints (this includes joints) in the current simulation step.

PxU32 PxSimulationStatistics::requiredContactConstraintMemory

The total required size (in bytes) of the contact constraints in the current simulation step.

PxU32 PxSimulationStatistics::totalDiscreteContactPairsAnyShape

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

PxSimulationStatistics.h

Public Types

Public Member Functions

Public Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation