PxMaterial
Defined in include/PxMaterial.h
Inheritance Relationships
Base Type
public PxBaseMaterial
(PxBaseMaterial)
-
class PxMaterial : public PxBaseMaterial
Material class to represent a set of surface properties.
See also
Public Functions
-
virtual void setDynamicFriction(PxReal coef) = 0
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.
See also
- Parameters
coef – [in] Coefficient of dynamic friction. Range: [0, PX_MAX_F32)
-
virtual PxReal getDynamicFriction() const = 0
Retrieves the DynamicFriction value.
See also
- Returns
The coefficient of dynamic friction.
-
virtual void setStaticFriction(PxReal coef) = 0
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.
See also
- Parameters
coef – [in] Coefficient of static friction. Range: [0, PX_MAX_F32)
-
virtual PxReal getStaticFriction() const = 0
Retrieves the coefficient of static friction.
See also
- Returns
The coefficient of static friction.
-
virtual void setRestitution(PxReal rest) = 0
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.
This property is overloaded when PxMaterialFlag::eCOMPLIANT_CONTACT flag is enabled. This permits negative values for restitution to be provided. The negative values are converted into spring stiffness terms for an implicit spring simulated at the contact site, with the spring positional error defined by the contact separation value. Higher stiffness terms produce stiffer springs that behave more like a rigid contact.
Sleeping: Does NOT wake any actors which may be affected.
See also
- Parameters
rest – [in] Coefficient of restitution. Range: [-INF,1]
-
virtual PxReal getRestitution() const = 0
Retrieves the coefficient of restitution.
See setRestitution.
See also
- Returns
The coefficient of restitution.
-
virtual void setDamping(PxReal damping) = 0
Sets the coefficient of damping.
This property only affects the simulation if PxMaterialFlag::eCOMPLIANT_CONTACT is raised. Damping works together with spring stiffness (set through a negative restitution value). Spring stiffness corrects positional error while damping resists relative velocity. Setting a high damping coefficient can produce spongy contacts.
Sleeping: Does NOT wake any actors which may be affected.
See also
- Parameters
damping – [in] Coefficient of damping. Range: [0,INF]
-
virtual PxReal getDamping() const = 0
Retrieves the coefficient of damping.
See setDamping.
See also
- Returns
The coefficient of damping.
-
virtual void setFlag(PxMaterialFlag::Enum flag, bool b) = 0
Raises or clears a particular material flag.
See the list of flags PxMaterialFlag
Default: eIMPROVED_PATCH_FRICTION
Sleeping: Does NOT wake any actors which may be affected.
See also
- Parameters
flag – [in] The PxMaterial flag to raise(set) or clear.
b – [in] New state of the flag
-
virtual void setFlags(PxMaterialFlags flags) = 0
sets all the material flags.
See the list of flags PxMaterialFlag
Default: eIMPROVED_PATCH_FRICTION
Sleeping: Does NOT wake any actors which may be affected.
See also
- Parameters
flags – [in] All PxMaterial flags
-
virtual PxMaterialFlags getFlags() const = 0
Retrieves the flags.
See PxMaterialFlag.
See also
- Returns
The material flags.
-
virtual void setFrictionCombineMode(PxCombineMode::Enum combMode) = 0
Sets the friction combine mode.
See the enum PxCombineMode .
Default: PxCombineMode::eAVERAGE
Sleeping: Does NOT wake any actors which may be affected.
- Parameters
combMode – [in] Friction combine mode to set for this material. See PxCombineMode.
-
virtual PxCombineMode::Enum getFrictionCombineMode() const = 0
Retrieves the friction combine mode.
See also
- Returns
The friction combine mode for this material.
-
virtual void setRestitutionCombineMode(PxCombineMode::Enum combMode) = 0
Sets the restitution combine mode.
See the enum PxCombineMode .
Default: PxCombineMode::eAVERAGE
Sleeping: Does NOT wake any actors which may be affected.
- Parameters
combMode – [in] Restitution combine mode for this material. See PxCombineMode.
-
virtual PxCombineMode::Enum getRestitutionCombineMode() const = 0
Retrieves the restitution combine mode.
See setRestitutionCombineMode.
- Returns
The coefficient of restitution combine mode for this material.
-
inline virtual const char *getConcreteTypeName() const override
Returns string name of dynamic type.
- Returns
Class name of most derived type of this object.
-
virtual void release() = 0
Decrements the reference count of the object and releases it if the new reference count is zero.
-
virtual PxU32 getReferenceCount() const = 0
Returns the reference count of the object.
At creation, the reference count of the object is 1. Every other object referencing this object increments the count by 1. When the reference count reaches 0, and only then, the object gets destroyed automatically.
- Returns
the current reference count.
-
virtual void acquireReference() = 0
Acquires a counted reference to this object.
This method increases the reference count of the object by 1. Decrement the reference count by calling release()
-
inline PxType getConcreteType() const
Returns concrete type of object.
See also
- 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.
See also
- Returns
Whether the class is subordinate
Public Members
-
void *userData
user can assign this to whatever, usually to create a 1:1 relationship with a user object.
Protected Functions
-
inline PxMaterial(PxType concreteType, PxBaseFlags baseFlags)
-
inline PxMaterial(PxBaseFlags baseFlags)
-
inline virtual ~PxMaterial()
-
inline virtual bool isKindOf(const char *name) const
Returns whether a given type name matches with the type of this instance.
-
inline virtual void onRefCountZero()
-
template<class T>
inline bool typeMatch() const
-
virtual void setDynamicFriction(PxReal coef) = 0