PxActor Class Reference
[Physics]

PxActor is the base class for the main simulation objects in the physics SDK. More...

#include <PxActor.h>

Inheritance diagram for PxActor:

[legend]

Collaboration diagram for PxActor:

[legend]

List of all members.


Public Member Functions
virtual void	release ()=0
	Deletes the actor.
virtual PxActorType::Enum	getType () const =0
	Retrieves the type of actor.
PX_DEPRECATED PX_INLINE PxRigidStatic *	isRigidStatic ()
	Attempts to cast to specific actor type.
PX_DEPRECATED PX_INLINE const PxRigidStatic *	isRigidStatic () const
PX_DEPRECATED PX_INLINE PxRigidDynamic *	isRigidDynamic ()
PX_DEPRECATED PX_INLINE const PxRigidDynamic *	isRigidDynamic () const
PX_DEPRECATED PX_INLINE PxParticleSystem *	isParticleSystem ()
PX_DEPRECATED PX_INLINE const PxParticleSystem *	isParticleSystem () const
PX_DEPRECATED PX_INLINE PxParticleFluid *	isParticleFluid ()
PX_DEPRECATED PX_INLINE const PxParticleFluid *	isParticleFluid () const
PX_DEPRECATED PX_INLINE PxArticulationLink *	isArticulationLink ()
PX_DEPRECATED PX_INLINE const PxArticulationLink *	isArticulationLink () const
PX_DEPRECATED PX_INLINE PxCloth *	isCloth ()
PX_DEPRECATED PX_INLINE const PxCloth *	isCloth () const
PX_DEPRECATED PX_INLINE PxRigidActor *	isRigidActor ()
PX_DEPRECATED PX_INLINE const PxRigidActor *	isRigidActor () const
PX_DEPRECATED PX_INLINE PxRigidBody *	isRigidBody ()
PX_DEPRECATED PX_INLINE const PxRigidBody *	isRigidBody () const
PX_DEPRECATED PX_INLINE PxParticleBase *	isParticleBase ()
PX_DEPRECATED PX_INLINE const PxParticleBase *	isParticleBase () const
virtual PxScene *	getScene () const =0
	Retrieves the scene which this actor belongs to.
virtual void	setName (const char *name)=0
	Sets a name string for the object that can be retrieved with getName().
virtual const char *	getName () const =0
	Retrieves the name string set with setName().
virtual PxBounds3	getWorldBounds () const =0
	Retrieves the axis aligned bounding box enclosing the actor.
virtual void	setActorFlag (PxActorFlag::Enum flag, bool value)=0
	Raises or clears a particular actor flag.
virtual void	setActorFlags (PxActorFlags inFlags)=0
	sets the actor flags
virtual PxActorFlags	getActorFlags () const =0
	Reads the PxActor flags.
virtual void	setDominanceGroup (PxDominanceGroup dominanceGroup)=0
	Assigns dynamic actors a dominance group identifier.
virtual PxDominanceGroup	getDominanceGroup () const =0
	Retrieves the value set with setDominanceGroup().
virtual void	setOwnerClient (PxClientID inClient)=0
	Sets the owner client of an actor.
virtual PxClientID	getOwnerClient () const =0
	Returns the owner client that was specified with at creation time.
virtual void	setClientBehaviorBits (PxU32)=0
	Sets the behavior bits of the actor.
virtual PxU32	getClientBehaviorBits () const =0
	Retrieves the behavior bits of the actor.
virtual PxAggregate *	getAggregate () const =0
	Retrieves the aggregate the actor might be a part of.
Public Attributes
void *	userData
	user can assign this to whatever, usually to create a 1:1 relationship with a user object.
Protected Member Functions
	PxActor (PxRefResolver &v)
PX_INLINE	PxActor ()
virtual	~PxActor ()
virtual bool	isKindOf (const char *name) const

Detailed Description

PxActor is the base class for the main simulation objects in the physics SDK.

The actor is owned by and contained in a PxScene.

Constructor & Destructor Documentation

PxActor::PxActor ( PxRefResolver & v ) [inline, protected]

PX_INLINE PxActor::PxActor ( ) [inline, protected]

virtual PxActor::~PxActor ( ) [inline, protected, virtual]

Member Function Documentation

virtual PxActorFlags PxActor::getActorFlags ( ) const [pure virtual]

Reads the PxActor flags.

See the list of flags PxActorFlag

Returns:: The values of the PxActor flags.

See also:: PxActorFlag setActorFlag()

virtual PxAggregate* PxActor::getAggregate ( ) const [pure virtual]

Retrieves the aggregate the actor might be a part of.

Returns:: The aggregate the actor is a part of, or NULL if the actor does not belong to an aggregate.

See also:: PxAggregate

virtual PxU32 PxActor::getClientBehaviorBits ( ) const [pure virtual]

Retrieves the behavior bits of the actor.

The behavior bits determine which types of events the actor will broadcast to foreign clients.

See also:: PxActorClientBehaviorBit setClientBehaviorBits

virtual PxDominanceGroup PxActor::getDominanceGroup ( ) const [pure virtual]

Retrieves the value set with setDominanceGroup().

Returns:: The dominance group of this actor.

See also:: setDominanceGroup() PxDominanceGroup PxScene::setDominanceGroupPair()

virtual const char* PxActor::getName ( ) const [pure virtual]

Retrieves the name string set with setName().

Returns:: Name string associated with object.

See also:: setName()

virtual PxClientID PxActor::getOwnerClient ( ) const [pure virtual]

Returns the owner client that was specified with at creation time.

This value cannot be changed once the object is placed into the scene.

See also:: PxClientID

virtual PxScene* PxActor::getScene ( ) const [pure virtual]

Retrieves the scene which this actor belongs to.

Returns:: Owner Scene. NULL if not part of a scene.

See also:: PxScene

virtual PxActorType::Enum PxActor::getType ( ) const [pure virtual]

Retrieves the type of actor.

Returns:: The actor type of the actor.

See also:: PxActorType

virtual PxBounds3 PxActor::getWorldBounds ( ) const [pure virtual]

Retrieves the axis aligned bounding box enclosing the actor.

Returns:: The actor's bounding box.

See also:: PxBounds3

Implemented in PxCloth.

virtual bool PxActor::isKindOf ( const char * name ) const [inline, protected, virtual]

Reimplemented from PxSerializable.

Reimplemented in PxArticulationLink, PxRigidActor, PxRigidBody, PxRigidDynamic, PxRigidStatic, PxCloth, PxParticleBase, PxParticleFluid, and PxParticleSystem.

References PxSerializable::isKindOf().

Referenced by PxRigidActor::isKindOf(), PxParticleBase::isKindOf(), and PxCloth::isKindOf().

virtual void PxActor::release ( ) [pure virtual]

Deletes the actor.

Do not keep a reference to the deleted instance.

Sleeping: If this is a PxRigidDynamic, this call will awaken any sleeping actors contacting the deleted actor (directly or indirectly).

If the actor belongs to a PxAggregate object, it is automatically removed from the aggregate.

See also:: PxScene::createRigidStatic(), PxScene::createRigidDynamic(), PxScene::createParticleSystem(), PxScene::createParticleFluid(), PxAggregate

Implemented in PxArticulationLink, PxRigidActor, PxRigidStatic, and PxCloth.

virtual void PxActor::setActorFlag	(	PxActorFlag::Enum	flag,
		bool	value
	)			`[pure virtual]`

Raises or clears a particular actor flag.

See the list of flags PxActorFlag

Sleeping: Does NOT wake the actor up automatically.

Parameters:

`[in]`	flag	The PxActor flag to raise(set) or clear. See PxActorFlag.
`[in]`	value	The boolean value to assign to the flag.

Default: PxActorFlag::eVISUALIZATION

See also:: PxActorFlag getActorFlags()

virtual void PxActor::setActorFlags ( PxActorFlags inFlags ) [pure virtual]

sets the actor flags

See the list of flags PxActorFlag

See also:: PxActorFlag setActorFlag()

virtual void PxActor::setClientBehaviorBits ( PxU32 ) [pure virtual]

Sets the behavior bits of the actor.

The behavior bits determine which types of events the actor will broadcast to foreign clients. The actor will always send notice for all possible events to its own owner client. By default it will not send any events to any other clients. If the user however raises a bit flag for any event type using this function, that event will then be sent also to any other clients which are programmed to listed to foreign actor events of that type.

Default: 0

See also:: PxClientID PxActorClientBehaviorBit PxScene::setClientBehaviorBits()

virtual void PxActor::setDominanceGroup ( PxDominanceGroup dominanceGroup ) [pure virtual]

Assigns dynamic actors a dominance group identifier.

PxDominanceGroup is a 5 bit group identifier (legal range from 0 to 31).

The PxScene::setDominanceGroupPair() lets you set certain behaviors for pairs of dominance groups. By default every dynamic actor is created in group 0.

Default: 0

Sleeping: Changing the dominance group does NOT wake the actor up automatically.

Parameters:

[in] dominanceGroup The dominance group identifier. Range: [0..31]

See also:: getDominanceGroup() PxDominanceGroup PxScene::setDominanceGroupPair()

virtual void PxActor::setName ( const char * name ) [pure virtual]

Sets a name string for the object that can be retrieved with getName().

This is for debugging and is not used by the SDK. The string is not copied by the SDK, only the pointer is stored.

Parameters:

[in] name String to set the objects name to.

Default: NULL

See also:: getName()

virtual void PxActor::setOwnerClient ( PxClientID inClient ) [pure virtual]

Sets the owner client of an actor.

This cannot be done once the actor has been placed into a scene.

Default: PX_DEFAULT_CLIENT

See also:: PxClientID

Member Data Documentation

void* PxActor::userData

user can assign this to whatever, usually to create a 1:1 relationship with a user object.

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

PhysX SDK 3.2 API Reference: PxActor Class Reference

PhysX SDK 3.2 API

PxActor Class Reference
[Physics]

Public Member Functions

Public Attributes

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

Get in touch

PhysX SDK 3.2 API Reference: PxActor Class Reference

PhysX SDK 3.2 API

PxActor Class Reference [Physics]

Public Member Functions

Public Attributes

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

PxActor Class Reference
[Physics]