PxMaterial Class Reference
[Physics]

Material class to represent a set of surface properties. More...

#include <PxMaterial.h>

Inheritance diagram for PxMaterial:

[legend]

Collaboration diagram for PxMaterial:

[legend]

List of all members.

Public Member Functions
virtual void	release ()=0
	Decrements the reference count of a material and releases it if the new reference count is zero.
virtual PxU32	getReferenceCount () const =0
	Returns the reference count of the material.
virtual void	acquireReference ()=0
	Acquires a counted reference to a material.
virtual void	setDynamicFriction (PxReal coef)=0
	Sets the coefficient of dynamic friction.
virtual PxReal	getDynamicFriction () const =0
	Retrieves the DynamicFriction value.
virtual void	setStaticFriction (PxReal coef)=0
	Sets the coefficient of static friction.
virtual PxReal	getStaticFriction () const =0
	Retrieves the coefficient of static friction.
virtual void	setRestitution (PxReal rest)=0
	Sets the coefficient of restitution.
virtual PxReal	getRestitution () const =0
	Retrieves the coefficient of restitution.
virtual void	setFlag (PxMaterialFlag::Enum flag, bool)=0
	Raises or clears a particular material flag.
virtual void	setFlags (PxMaterialFlags inFlags)=0
	sets all the material flags.
virtual PxMaterialFlags	getFlags () const =0
	Retrieves the flags. See PxMaterialFlag.
virtual void	setFrictionCombineMode (PxCombineMode::Enum combMode)=0
	Sets the friction combine mode.
virtual PxCombineMode::Enum	getFrictionCombineMode () const =0
	Retrieves the friction combine mode.
virtual void	setRestitutionCombineMode (PxCombineMode::Enum combMode)=0
	Sets the restitution combine mode.
virtual PxCombineMode::Enum	getRestitutionCombineMode () const =0
	Retrieves the restitution combine mode.
virtual const char *	getConcreteTypeName () const
	Returns string name of dynamic type.
Public Attributes
void *	userData
	user can assign this to whatever, usually to create a 1:1 relationship with a user object.
Protected Member Functions
PX_INLINE	PxMaterial (PxType concreteType, PxBaseFlags baseFlags)
PX_INLINE	PxMaterial (PxBaseFlags baseFlags)
virtual	~PxMaterial ()
virtual bool	isKindOf (const char *name) const
	Returns whether a given type name matches with the type of this instance.

---

Detailed Description

Material class to represent a set of surface properties.

See also:

PxPhysics.createMaterial

---

Constructor & Destructor Documentation

PX_INLINE PxMaterial::PxMaterial	(	PxType	concreteType,
		PxBaseFlags	baseFlags
	)			[inline, protected]

PX_INLINE PxMaterial::PxMaterial

(

PxBaseFlags

baseFlags

)

[inline, protected]

virtual PxMaterial::~PxMaterial

(

)

[inline, protected, virtual]

---

Member Function Documentation

virtual void PxMaterial::acquireReference

(

)

[pure virtual]

Acquires a counted reference to a material.

This method increases the reference count of the material by 1. Decrement the reference count by calling release()

virtual const char* PxMaterial::getConcreteTypeName

(

)

const [inline, virtual]

Returns string name of dynamic type.

Returns:

Class name of most derived type of this object.

Implements PxBase.

virtual PxReal PxMaterial::getDynamicFriction

(

)

const [pure virtual]

Retrieves the DynamicFriction value.

Returns:

The coefficient of dynamic friction.

See also:

setDynamicFriction

virtual PxMaterialFlags PxMaterial::getFlags

(

)

const [pure virtual]

Retrieves the flags. See PxMaterialFlag.

Returns:

The material flags.

See also:

PxMaterialFlag setFlags()

virtual PxCombineMode::Enum PxMaterial::getFrictionCombineMode

(

)

const [pure virtual]

Retrieves the friction combine mode.

See setFrictionCombineMode.

Returns:

The friction combine mode for this material.

See also:

PxCombineMode setFrictionCombineMode()

virtual PxU32 PxMaterial::getReferenceCount

(

)

const [pure virtual]

Returns the reference count of the material.

At creation, the reference count of the material is 1. Every shape referencing this material increments the count by 1. When the reference count reaches 0, and only then, the material gets destroyed automatically.

Returns:

the current reference count.

virtual PxReal PxMaterial::getRestitution

(

)

const [pure virtual]

Retrieves the coefficient of restitution.

See setRestitution.

Returns:

The coefficient of restitution.

See also:

setRestitution()

virtual PxCombineMode::Enum PxMaterial::getRestitutionCombineMode

(

)

const [pure virtual]

Retrieves the restitution combine mode.

See setRestitutionCombineMode.

Returns:

The coefficient of restitution combine mode for this material.

See also:

PxCombineMode setRestitutionCombineMode getRestitution()

virtual PxReal PxMaterial::getStaticFriction

(

)

const [pure virtual]

Retrieves the coefficient of static friction.

Returns:

The coefficient of static friction.

See also:

setStaticFriction

virtual bool PxMaterial::isKindOf

(

const char *

superClass

)

const [inline, protected, virtual]

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

Reimplemented from PxBase.

References PxBase::isKindOf().

virtual void PxMaterial::release

(

)

[pure virtual]

Decrements the reference count of a material and releases it if the new reference count is zero.

See also:

PxPhysics.createMaterial()

Implements PxBase.

virtual void PxMaterial::setDynamicFriction

(

PxReal

coef

)

[pure virtual]

Sets the coefficient of dynamic friction.

The coefficient of dynamic friction should be in [0, PX_MAX_F32). If set to greater than staticFriction, the effective value of staticFriction will be increased to match.

Sleeping: Does NOT wake any actors which may be affected.

Parameters:

[in]

coef

Coefficient of dynamic friction. Range: [0, PX_MAX_F32)

See also:

getDynamicFriction()

virtual void PxMaterial::setFlag	(	PxMaterialFlag::Enum	flag,
		bool
	)			[pure virtual]

Raises or clears a particular material flag.

See the list of flags PxMaterialFlag

Sleeping: Does NOT wake any actors which may be affected.

Parameters:

[in]

flag

The PxMaterial flag to raise(set) or clear.

See also:

getFlags() PxMaterialFlag

virtual void PxMaterial::setFlags

(

PxMaterialFlags

inFlags

)

[pure virtual]

sets all the material flags.

See the list of flags PxMaterialFlag

Sleeping: Does NOT wake any actors which may be affected.

virtual void PxMaterial::setFrictionCombineMode

(

PxCombineMode::Enum

combMode

)

[pure virtual]

Sets the friction combine mode.

See the enum PxCombineMode .

Sleeping: Does NOT wake any actors which may be affected.

Parameters:

[in]

combMode

Friction combine mode to set for this material. See PxCombineMode.

See also:

PxCombineMode getFrictionCombineMode setStaticFriction() setDynamicFriction()

virtual void PxMaterial::setRestitution

(

PxReal

rest

)

[pure virtual]

Sets the coefficient of restitution.

A coefficient of 0 makes the object bounce as little as possible, higher values up to 1.0 result in more bounce.

Sleeping: Does NOT wake any actors which may be affected.

Parameters:

[in]

rest

Coefficient of restitution. Range: [0,1]

See also:

getRestitution()

virtual void PxMaterial::setRestitutionCombineMode

(

PxCombineMode::Enum

combMode

)

[pure virtual]

Sets the restitution combine mode.

See the enum PxCombineMode .

Sleeping: Does NOT wake any actors which may be affected.

Parameters:

[in]

combMode

Restitution combine mode for this material. See PxCombineMode.

See also:

PxCombineMode getRestitutionCombineMode() setRestitution()

virtual void PxMaterial::setStaticFriction

(

PxReal

coef

)

[pure virtual]

Sets the coefficient of static friction.

The coefficient of static friction should be in the range [0, PX_MAX_F32)

Sleeping: Does NOT wake any actors which may be affected.

Parameters:

[in]

coef

Coefficient of static friction. Range: [0, PX_MAX_F32)

See also:

getStaticFriction()

---

Member Data Documentation

void* PxMaterial::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 file:

• PxMaterial.h