a base interface providing common functionality for PhysX joints More...

#include <PxJoint.h>

Inheritance diagram for PxJoint:

Collaboration diagram for PxJoint:

Public Member Functions
virtual void	setActors (PxRigidActor actor0, PxRigidActor actor1)=0
	Set the actors for this joint. More...

virtual void	getActors (PxRigidActor &actor0, PxRigidActor &actor1) const =0
	Get the actors for this joint. More...

virtual void	setLocalPose (PxJointActorIndex::Enum actor, const PxTransform &localPose)=0
	Set the joint local pose for an actor. More...

virtual PxTransform	getLocalPose (PxJointActorIndex::Enum actor) const =0
	get the joint local pose for an actor. More...

virtual PxTransform	getRelativeTransform () const =0
	get the relative pose for this joint More...

virtual PxVec3	getRelativeLinearVelocity () const =0
	get the relative linear velocity of the joint More...

virtual PxVec3	getRelativeAngularVelocity () const =0
	get the relative angular velocity of the joint More...

virtual void	setBreakForce (PxReal force, PxReal torque)=0
	set the break force for this joint. More...

virtual void	getBreakForce (PxReal &force, PxReal &torque) const =0
	get the break force for this joint. More...

virtual void	setConstraintFlags (PxConstraintFlags flags)=0
	set the constraint flags for this joint. More...

virtual void	setConstraintFlag (PxConstraintFlag::Enum flag, bool value)=0
	set a constraint flags for this joint to a specified value. More...

virtual PxConstraintFlags	getConstraintFlags () const =0
	get the constraint flags for this joint. More...

virtual void	setInvMassScale0 (PxReal invMassScale)=0
	set the inverse mass scale for actor0. More...

virtual PxReal	getInvMassScale0 () const =0
	get the inverse mass scale for actor0. More...

virtual void	setInvInertiaScale0 (PxReal invInertiaScale)=0
	set the inverse inertia scale for actor0. More...

virtual PxReal	getInvInertiaScale0 () const =0
	get the inverse inertia scale for actor0. More...

virtual void	setInvMassScale1 (PxReal invMassScale)=0
	set the inverse mass scale for actor1. More...

virtual PxReal	getInvMassScale1 () const =0
	get the inverse mass scale for actor1. More...

virtual void	setInvInertiaScale1 (PxReal invInertiaScale)=0
	set the inverse inertia scale for actor1. More...

virtual PxReal	getInvInertiaScale1 () const =0
	get the inverse inertia scale for actor1. More...

virtual PxConstraint *	getConstraint () const =0
	Retrieves the PxConstraint corresponding to this joint. More...

virtual void	setName (const char *name)=0
	Sets a name string for the object that can be retrieved with getName(). More...

virtual const char *	getName () const =0
	Retrieves the name string set with setName(). More...

virtual void	release ()=0
	Deletes the joint. More...

virtual PxScene *	getScene () const =0
	Retrieves the scene which this joint belongs to. More...

PX_DEPRECATED PxJointType::Enum	getType ()
	Deprecated method to retrieves the type of this joint. Please use getConcreteType() More...

Public Member Functions inherited from PxBase
virtual const char *	getConcreteTypeName () const
	Returns string name of dynamic type. More...

template<class T >
T *	is ()

template<class T >
const T *	is () const

PX_INLINE PxType	getConcreteType () const
	Returns concrete type of object. More...

PX_INLINE void	setBaseFlag (PxBaseFlag::Enum flag, bool value)
	Set PxBaseFlag. More...

PX_INLINE void	setBaseFlags (PxBaseFlags inFlags)
	Set PxBaseFlags. More...

PX_INLINE PxBaseFlags	getBaseFlags () const
	Returns PxBaseFlags. More...

virtual bool	isReleasable () const
	Whether the object is subordinate. More...

Static Public Member Functions
static void	getBinaryMetaData (PxOutputStream &stream)
	Put class meta data in stream, used for serialization. More...

Public Attributes
void *	userData
	user can assign this to whatever, usually to create a 1:1 relationship with a user object. More...

Protected Member Functions
virtual	~PxJoint ()

PX_INLINE	PxJoint (PxType concreteType, PxBaseFlags baseFlags)
	Constructor. More...

PX_INLINE	PxJoint (PxBaseFlags baseFlags)
	Deserialization constructor. More...

virtual bool	isKindOf (const char *name) const
	Returns whether a given type name matches with the type of this instance. More...

Protected Member Functions inherited from PxBase
PX_INLINE	PxBase (PxType concreteType, PxBaseFlags baseFlags)
	Constructor setting concrete type and base flags. More...

PX_INLINE	PxBase (PxBaseFlags baseFlags)
	Deserialization constructor setting base flags. More...

virtual	~PxBase ()
	Destructor. More...

template<class T >
bool	typeMatch () const

Additional Inherited Members
Protected Attributes inherited from PxBase
PxType	mConcreteType

PxBaseFlags	mBaseFlags

Detailed Description

a base interface providing common functionality for PhysX joints

Constructor & Destructor Documentation

virtual PxJoint::~PxJoint ( )

inlineprotectedvirtual

PX_INLINE PxJoint::PxJoint	(	PxType	concreteType,
		PxBaseFlags	baseFlags
	)

inlineprotected

Constructor.

PX_INLINE PxJoint::PxJoint ( PxBaseFlags baseFlags )

inlineprotected

Deserialization constructor.

Member Function Documentation

virtual void PxJoint::getActors	(	PxRigidActor *&	actor0,
		PxRigidActor *&	actor1
	)		const

pure virtual

Get the actors for this joint.

Parameters

[out]	actor0	the first actor.
[out]	actor1	the second actor

See Also: setActors()

static void PxJoint::getBinaryMetaData ( PxOutputStream & stream )

static

Put class meta data in stream, used for serialization.

virtual void PxJoint::getBreakForce	(	PxReal &	force,
		PxReal &	torque
	)		const

pure virtual

get the break force for this joint.

Parameters

[out]	force	the maximum force the joint can apply before breaking
[out]	torque	the maximum torque the joint can apply before breaking

See Also: setBreakForce()

virtual PxConstraint* PxJoint::getConstraint ( ) const

pure virtual

Retrieves the PxConstraint corresponding to this joint.

This can be used to determine, among other things, the force applied at the joint.

Returns: the constraint

virtual PxConstraintFlags PxJoint::getConstraintFlags ( ) const

pure virtual

get the constraint flags for this joint.

Returns: the constraint flags

See Also: PxConstraintFlag

virtual PxReal PxJoint::getInvInertiaScale0 ( ) const

pure virtual

get the inverse inertia scale for actor0.

Returns: inverse inertia scale for actor0

See Also: setInvInertiaScale0

virtual PxReal PxJoint::getInvInertiaScale1 ( ) const

pure virtual

get the inverse inertia scale for actor1.

Returns: inverse inertia scale for actor1

See Also: setInvInertiaScale1

virtual PxReal PxJoint::getInvMassScale0 ( ) const

pure virtual

get the inverse mass scale for actor0.

Returns: inverse mass scale for actor0

See Also: setInvMassScale0

virtual PxReal PxJoint::getInvMassScale1 ( ) const

pure virtual

get the inverse mass scale for actor1.

Returns: inverse mass scale for actor1

See Also: setInvMassScale1

virtual PxTransform PxJoint::getLocalPose ( PxJointActorIndex::Enum actor ) const

pure virtual

get the joint local pose for an actor.

Parameters

[in] actor 0 for the first actor, 1 for the second actor.

return the local pose for this joint

See Also: setLocalPose()

virtual const char* PxJoint::getName ( ) const

pure virtual

Retrieves the name string set with setName().

Returns: Name string associated with object.

See Also: setName()

virtual PxVec3 PxJoint::getRelativeAngularVelocity ( ) const

pure virtual

get the relative angular velocity of the joint

This function returns the angular velocity of actor1 relative to actor0. The value is returned in the constraint frame of actor0

virtual PxVec3 PxJoint::getRelativeLinearVelocity ( ) const

pure virtual

get the relative linear velocity of the joint

This function returns the linear velocity of the origin of the constraint frame of actor1, relative to the origin of the constraint frame of actor0. The value is returned in the constraint frame of actor0

virtual PxTransform PxJoint::getRelativeTransform ( ) const

pure virtual

get the relative pose for this joint

This function returns the pose of the joint frame of actor1 relative to actor0

virtual PxScene* PxJoint::getScene ( ) const

pure virtual

Retrieves the scene which this joint belongs to.

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

See Also: PxScene

PX_DEPRECATED PxJointType::Enum PxJoint::getType ( )

inline

Deprecated method to retrieves the type of this joint. Please use getConcreteType()

Deprecated:

Returns: the joint type

See Also: PxJointType PxBase::getConcreteType()

virtual bool PxJoint::isKindOf ( const char * name ) const

inlineprotectedvirtual

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

Reimplemented from PxBase.

Reimplemented in PxD6Joint, PxRevoluteJoint, PxDistanceJoint, PxPrismaticJoint, PxSphericalJoint, and PxFixedJoint.

References PxBase::isKindOf().

Referenced by PxFixedJoint::isKindOf(), PxSphericalJoint::isKindOf(), PxPrismaticJoint::isKindOf(), PxDistanceJoint::isKindOf(), PxRevoluteJoint::isKindOf(), and PxD6Joint::isKindOf().

virtual void PxJoint::release ( )

pure virtual

Deletes the joint.

Note: This call does not wake up the connected rigid bodies.

Implements PxBase.

virtual void PxJoint::setActors	(	PxRigidActor *	actor0,
		PxRigidActor *	actor1
	)

pure virtual

Set the actors for this joint.

An actor may be NULL to indicate the world frame. At most one of the actors may be NULL.

Parameters

[in]	actor0	the first actor.
[in]	actor1	the second actor

See Also: getActors()

virtual void PxJoint::setBreakForce	(	PxReal	force,
		PxReal	torque
	)

pure virtual

set the break force for this joint.

if the constraint force or torque on the joint exceeds the specified values, the joint will break, at which point it will not constrain the two actors and the flag PxConstraintFlag::eBROKEN will be set. The force and torque are measured in the joint frame of the first actor

Parameters

[in]	force	the maximum force the joint can apply before breaking
[in]	torque	the maximum torque the joint can apply before breaking

virtual void PxJoint::setConstraintFlag	(	PxConstraintFlag::Enum	flag,
		bool	value
	)

pure virtual

set a constraint flags for this joint to a specified value.

Parameters

[in]	flag	the constraint flag
[in]	value	the value to which to set the flag

See Also: PxConstraintFlag

virtual void PxJoint::setConstraintFlags ( PxConstraintFlags flags )

pure virtual

set the constraint flags for this joint.

Parameters

[in] flags the constraint flags

See Also: PxConstraintFlag

virtual void PxJoint::setInvInertiaScale0 ( PxReal invInertiaScale )

pure virtual

set the inverse inertia scale for actor0.

Parameters

[in] invInertiaScale the scale to apply to the inverse inertia of actor0 for resolving this constraint

See Also: getInvMassScale0

virtual void PxJoint::setInvInertiaScale1 ( PxReal invInertiaScale )

pure virtual

set the inverse inertia scale for actor1.

Parameters

[in] invInertiaScale the scale to apply to the inverse inertia of actor1 for resolving this constraint

See Also: getInvInertiaScale1

virtual void PxJoint::setInvMassScale0 ( PxReal invMassScale )

pure virtual

set the inverse mass scale for actor0.

Parameters

[in] invMassScale the scale to apply to the inverse mass of actor 0 for resolving this constraint

See Also: getInvMassScale0

virtual void PxJoint::setInvMassScale1 ( PxReal invMassScale )

pure virtual

set the inverse mass scale for actor1.

Parameters

[in] invMassScale the scale to apply to the inverse mass of actor 1 for resolving this constraint

See Also: getInvMassScale1

virtual void PxJoint::setLocalPose	(	PxJointActorIndex::Enum	actor,
		const PxTransform &	localPose
	)

pure virtual

Set the joint local pose for an actor.

This is the relative pose which locates the joint frame relative to the actor.

Parameters

[in]	actor	0 for the first actor, 1 for the second actor.
[in]	localPose	the local pose for the actor this joint

See Also: getLocalPose()

virtual void PxJoint::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.

See Also: getName()

Member Data Documentation

void* PxJoint::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:

PxJoint.h

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation