PxArticulationAttachment#

Defined in include/PxArticulationTendon.h

class PxArticulationAttachment : public PxBase#

Defines a spatial tendon attachment point on a link.

Public Functions

inline virtual ~PxArticulationAttachment()#
virtual void setRestLength(const PxReal restLength) = 0#

Sets the spring rest length for the sub-tendon from the root to this leaf attachment.

Setting this on non-leaf attachments has no effect.

Parameters:

restLength[in] The rest length of the spring. Default: 0

virtual PxReal getRestLength() const = 0#

Gets the spring rest length for the sub-tendon from the root to this leaf attachment.

See also

setRestLength()

Returns:

The rest length.

virtual void setLimitParameters(
const PxArticulationTendonLimit &parameters,
) = 0#

Sets the low and high limit on the length of the sub-tendon from the root to this leaf attachment.

Setting this on non-leaf attachments has no effect.

Parameters:

parameters[in] Struct with the low and high limit. Default: (PX_MAX_F32, -PX_MAX_F32) (i.e. an invalid configuration that can only work if stiffness is zero)

virtual PxArticulationTendonLimit getLimitParameters() const = 0#

Gets the low and high limit on the length of the sub-tendon from the root to this leaf attachment.

Returns:

Struct with the low and high limit.

virtual void setRelativeOffset(const PxVec3 &offset) = 0#

Sets the attachment’s relative offset in the link actor frame.

Parameters:

offset[in] The relative offset in the link actor frame.

virtual PxVec3 getRelativeOffset() const = 0#

Gets the attachment’s relative offset in the link actor frame.

Returns:

The relative offset in the link actor frame.

virtual void setCoefficient(const PxReal coefficient) = 0#

Sets the attachment coefficient.

See also

getCoefficient()

Parameters:

coefficient[in] The scale that the distance between this attachment and its parent is multiplied by when summing up the spatial tendon’s length.

virtual PxReal getCoefficient() const = 0#

Gets the attachment coefficient.

See also

setCoefficient()

Returns:

The scale that the distance between this attachment and its parent is multiplied by when summing up the spatial tendon’s length.

virtual PxArticulationLink *getLink() const = 0#

Gets the articulation link.

Returns:

The articulation link that this attachment is attached to.

virtual PxArticulationAttachment *getParent() const = 0#

Gets the parent attachment.

Returns:

The parent attachment.

virtual bool isLeaf() const = 0#

Indicates that this attachment is a leaf, and thus defines a sub-tendon from the root to this attachment.

Returns:

True: This attachment is a leaf and has zero children; False: Not a leaf.

virtual PxArticulationSpatialTendon *getTendon() const = 0#

Gets the spatial tendon that the attachment is a part of.

Returns:

The tendon.

virtual void release() = 0#

Releases the attachment.

Note

Releasing the attachment is not allowed while the articulation is in a scene. In order to release the attachment, remove and then re-add the articulation to the scene.

inline virtual const char *getConcreteTypeName(
) const final override#

Returns the string name of the dynamic type.

Returns:

The string name.

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

void *userData#

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

Protected Functions

inline PxArticulationAttachment(
PxType concreteType,
PxBaseFlags baseFlags,
)#
inline PxArticulationAttachment(PxBaseFlags baseFlags)#
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#