PxParticleBuffer

Defined in include/PxParticleBuffer.h

Inheritance Relationships

Base Type

Derived Types

class PxParticleBuffer : public PxBase

The shared base class for all particle buffers, can be instantiated directly to simulate granular and fluid particles.

See PxPhysics::createParticleBuffer.

A particle buffer is a container that specifies per-particle attributes of a set of particles that will be used during the simulation of a particle system. It exposes direct access to the underlying GPU buffers and is independent of the scene and particle system. Particle buffers can be added/removed from a particle system at any time between simulation steps, and transferred from one particle system to another.

Subclassed by PxParticleAndDiffuseBuffer, PxParticleClothBuffer, PxParticleRigidBuffer

Public Functions

virtual PxVec4 *getPositionInvMasses() const = 0

Get positions and inverse masses for this particle buffer.

Returns

A pointer to a device buffer containing the positions and inverse mass packed as PxVec4(pos.x, pos.y, pos.z, inverseMass).

virtual PxVec4 *getVelocities() const = 0

Get velocities for this particle buffer.

Returns

A pointer to a device buffer containing the velocities packed as PxVec4(vel.x, vel.y, vel.z, 0.0f).

virtual PxU32 *getPhases() const = 0

Get phases for this particle buffer.

See #PxParticlePhase

Returns

A pointer to a device buffer containing the per-particle phases for this particle buffer.

virtual PxParticleVolume *getParticleVolumes() const = 0

Get particle volumes for this particle buffer.

See PxParticleVolume

Returns

A pointer to a device buffer containing the PxParticleVolume s for this particle buffer.

virtual void setNbActiveParticles(PxU32 nbActiveParticles) = 0

Set the number of active particles for this particle buffer.

The number of active particles can be <= PxParticleBuffer::getMaxParticles(). The particle system will simulate the first x particles in the PxParticleBuffer, where x is the number of active particles.

Parameters

nbActiveParticles[in] The number of active particles.

virtual PxU32 getNbActiveParticles() const = 0

Get the number of active particles for this particle buffer.

Returns

The number of active particles.

virtual PxU32 getMaxParticles() const = 0

Get the maximum number particles this particle buffer can hold.

The maximum number of particles is specified when creating a PxParticleBuffer. See PxPhysics::createParticleBuffer.

Returns

The maximum number of particles.

virtual PxU32 getNbParticleVolumes() const = 0

Get the number of particle volumes in this particle buffer.

Returns

The number of PxParticleVolume s for this particle buffer.

virtual void setNbParticleVolumes(PxU32 nbParticleVolumes) = 0

Set the number of PxParticleVolume s for this particle buffer.

Parameters

nbParticleVolumes[in] The number of particle volumes in this particle buffer.

virtual PxU32 getMaxParticleVolumes() const = 0

Get the maximum number of particle volumes this particle buffer can hold.

See PxParticleVolume.

Returns

The maximum number of particle volumes this particle buffer can hold.

virtual void setRigidFilters(PxParticleRigidFilterPair *filters, PxU32 nbFilters) = 0

Set the PxParticleRigidFilterPair s for collision filtering of particles in this buffer with rigid bodies.

See PxParticleRigidFilterPair

Parameters
  • filters[in] A device buffer containing PxParticleRigidFilterPair s.

  • nbFilters[in] The number of particle-rigid body collision filtering pairs.

virtual void setRigidAttachments(PxParticleRigidAttachment *attachments, PxU32 nbAttachments) = 0

Set the particle-rigid body attachments for particles in this particle buffer.

See PxParticleRigidAttachment

Parameters
  • attachments[in] A device buffer containing PxParticleRigidAttachment s.

  • nbAttachments[in] The number of particle-rigid body attachments.

virtual PxU32 getFlatListStartIndex() const = 0

Get the start index for the first particle of this particle buffer in the complete list of particles of the particle system this buffer is used in.

The return value is only correct if the particle buffer is assigned to a particle system and at least one call to simulate() has been performed.

Returns

The index of the first particle in the complete particle list.

virtual void raiseFlags(PxParticleBufferFlag::Enum flags) = 0

Raise dirty flags on this particle buffer to communicate that the corresponding data has been updated by the user.

See PxParticleBufferFlag.

Parameters

flags[in] The flag corresponding to the data that is dirty.

virtual void release() = 0

Release this buffer and deallocate all the memory.

virtual void onParticleSystemDestroy() = 0

Cleanup helper used in case a particle system is released before the particle buffers have been removed.

virtual void setInternalData(void *data) = 0

Reserved for internal use.

virtual const char *getConcreteTypeName() const = 0

Returns string name of dynamic type.

Returns

Class name of most derived type of this object.

template<class T>
inline T *is()
template<class T>
inline const T *is() const
inline PxType getConcreteType() const

Returns concrete type of object.

See also

PxConcreteType

Returns

PxConcreteType::Enum of serialized object

inline void setBaseFlag(PxBaseFlag::Enum flag, bool value)

Set PxBaseFlag

Parameters
  • flag[in] The flag to be set

  • value[in] The flags new value

inline void setBaseFlags(PxBaseFlags inFlags)

Set PxBaseFlags

See also

PxBaseFlags

Parameters

inFlags[in] The flags to be set

inline PxBaseFlags getBaseFlags() const

Returns PxBaseFlags.

See also

PxBaseFlags

Returns

PxBaseFlags

inline virtual bool isReleasable() const

Whether the object is subordinate.

A class is subordinate, if it can only be instantiated in the context of another class.

Returns

Whether the class is subordinate

Public Members

PxU32 bufferIndex

Index of this buffer in the particle system it is assigned to.

const PxU32 bufferUniqueId

Unique index that does not change over the lifetime of a PxParticleBuffer.

Protected Functions

inline virtual ~PxParticleBuffer()
inline PxParticleBuffer(PxU32 uniqueId)
inline PxParticleBuffer(PxU32 uniqueId, PxType type)
inline virtual bool isKindOf(const char *superClass) const

Returns whether a given type name matches with the type of this instance.

template<class T>
inline bool typeMatch() const

Protected Attributes

PxType mConcreteType
PxBaseFlags mBaseFlags
PxU32 mBuiltInRefCount