btGeneric6DofConstraint Class Reference

btGeneric6DofConstraint between two rigidbodies each with a pivotpoint that descibes the axis location in local space More...

#include <btGeneric6DofConstraint.h>

Inheritance diagram for btGeneric6DofConstraint:

[legend]

Collaboration diagram for btGeneric6DofConstraint:

[legend]

List of all members.

Public Member Functions
	btGeneric6DofConstraint (btRigidBody &rbA, btRigidBody &rbB, const btTransform &frameInA, const btTransform &frameInB, bool useLinearReferenceFrameA)
	btGeneric6DofConstraint (btRigidBody &rbB, const btTransform &frameInB, bool useLinearReferenceFrameB)
void	calculateTransforms (const btTransform &transA, const btTransform &transB)
	Calcs global transform of the offsets.
void	calculateTransforms ()
const btTransform &	getCalculatedTransformA () const
	Gets the global transform of the offset for body A.
const btTransform &	getCalculatedTransformB () const
	Gets the global transform of the offset for body B.
const btTransform &	getFrameOffsetA () const
const btTransform &	getFrameOffsetB () const
btTransform &	getFrameOffsetA ()
btTransform &	getFrameOffsetB ()
virtual void	buildJacobian ()
	performs Jacobian calculation, and also calculates angle differences and axis
virtual void	getInfo1 (btConstraintInfo1 *info)
	internal method used by the constraint solver, don't use them directly
void	getInfo1NonVirtual (btConstraintInfo1 *info)
virtual void	getInfo2 (btConstraintInfo2 *info)
	internal method used by the constraint solver, don't use them directly
void	getInfo2NonVirtual (btConstraintInfo2 *info, const btTransform &transA, const btTransform &transB, const btVector3 &linVelA, const btVector3 &linVelB, const btVector3 &angVelA, const btVector3 &angVelB)
void	updateRHS (btScalar timeStep)
btVector3	getAxis (int axis_index) const
	Get the rotation axis in global coordinates.
btScalar	getAngle (int axis_index) const
	Get the relative Euler angle.
btScalar	getRelativePivotPosition (int axis_index) const
	Get the relative position of the constraint pivot.
bool	testAngularLimitMotor (int axis_index)
	Test angular limit.
void	setLinearLowerLimit (const btVector3 &linearLower)
void	setLinearUpperLimit (const btVector3 &linearUpper)
void	setAngularLowerLimit (const btVector3 &angularLower)
void	setAngularUpperLimit (const btVector3 &angularUpper)
btRotationalLimitMotor *	getRotationalLimitMotor (int index)
	Retrieves the angular limit informacion.
btTranslationalLimitMotor *	getTranslationalLimitMotor ()
	Retrieves the limit informacion.
void	setLimit (int axis, btScalar lo, btScalar hi)
bool	isLimited (int limitIndex)
	Test limit.
virtual void	calcAnchorPos (void)
int	get_limit_motor_info2 (btRotationalLimitMotor limot, const btTransform &transA, const btTransform &transB, const btVector3 &linVelA, const btVector3 &linVelB, const btVector3 &angVelA, const btVector3 &angVelB, btConstraintInfo2 info, int row, btVector3 &ax1, int rotational, int rotAllowed=false)
bool	getUseFrameOffset ()
void	setUseFrameOffset (bool frameOffsetOnOff)
virtual void	setParam (int num, btScalar value, int axis=-1)
	override the default global value of a parameter (such as ERP or CFM), optionally provide the axis (0..5).
virtual btScalar	getParam (int num, int axis=-1) const
	return the local value of parameter
virtual int	calculateSerializeBufferSize () const
virtual const char *	serialize (void dataBuffer, btSerializer serializer) const
	fills the dataBuffer and returns the struct name (and 0 on failure)
Public Attributes
bool	m_useSolveConstraintObsolete
	for backwards compatibility during the transition to 'getInfo/getInfo2'
Protected Member Functions
btGeneric6DofConstraint &	operator= (btGeneric6DofConstraint &other)
int	setAngularLimits (btConstraintInfo2 *info, int row_offset, const btTransform &transA, const btTransform &transB, const btVector3 &linVelA, const btVector3 &linVelB, const btVector3 &angVelA, const btVector3 &angVelB)
int	setLinearLimits (btConstraintInfo2 *info, int row, const btTransform &transA, const btTransform &transB, const btVector3 &linVelA, const btVector3 &linVelB, const btVector3 &angVelA, const btVector3 &angVelB)
void	buildLinearJacobian (btJacobianEntry &jacLinear, const btVector3 &normalWorld, const btVector3 &pivotAInW, const btVector3 &pivotBInW)
void	buildAngularJacobian (btJacobianEntry &jacAngular, const btVector3 &jointAxisW)
void	calculateLinearInfo ()
void	calculateAngleInfo ()
	calcs the euler angles between the two bodies.
Protected Attributes


btTransform	m_frameInA
	relative_frames
btTransform	m_frameInB
	the constraint space w.r.t body B
btJacobianEntry	m_jacLinear [3]
	Jacobians.
btJacobianEntry	m_jacAng [3]
	3 orthogonal angular constraints
btTranslationalLimitMotor	m_linearLimits
	Linear_Limit_parameters.
btRotationalLimitMotor	m_angularLimits [3]
	hinge_parameters
btScalar	m_timeStep
	temporal variables
btTransform	m_calculatedTransformA
btTransform	m_calculatedTransformB
btVector3	m_calculatedAxisAngleDiff
btVector3	m_calculatedAxis [3]
btVector3	m_calculatedLinearDiff
btScalar	m_factA
btScalar	m_factB
bool	m_hasStaticBody
btVector3	m_AnchorPos
bool	m_useLinearReferenceFrameA
bool	m_useOffsetForConstraintFrame
int	m_flags

Detailed Description

btGeneric6DofConstraint between two rigidbodies each with a pivotpoint that descibes the axis location in local space

btGeneric6DofConstraint can leave any of the 6 degree of freedom 'free' or 'locked'. currently this limit supports rotational motors

For Linear limits, use btGeneric6DofConstraint.setLinearUpperLimit, btGeneric6DofConstraint.setLinearLowerLimit. You can set the parameters with the btTranslationalLimitMotor structure accsesible through the btGeneric6DofConstraint.getTranslationalLimitMotor method. At this moment translational motors are not supported. May be in the future.
For Angular limits, use the btRotationalLimitMotor structure for configuring the limit. This is accessible through btGeneric6DofConstraint.getLimitMotor method, This brings support for limit parameters and motors.
Angulars limits have these possible ranges:

AXIS

MIN ANGLE

MAX ANGLE

X

-PI

PI

Y

-PI/2

PI/2

Z

-PI

PI

Definition at line 271 of file btGeneric6DofConstraint.h.

Constructor & Destructor Documentation

btGeneric6DofConstraint::btGeneric6DofConstraint	(	btRigidBody &	rbA,
		btRigidBody &	rbB,
		const btTransform &	frameInA,
		const btTransform &	frameInB,
		bool	useLinearReferenceFrameA
	)

Definition at line 38 of file btGeneric6DofConstraint.cpp.

btGeneric6DofConstraint::btGeneric6DofConstraint	(	btRigidBody &	rbB,
		const btTransform &	frameInB,
		bool	useLinearReferenceFrameB
	)

not providing rigidbody A means implicitly using worldspace for body A

Definition at line 52 of file btGeneric6DofConstraint.cpp.

Member Function Documentation

void btGeneric6DofConstraint::buildAngularJacobian	(	btJacobianEntry &	jacAngular,
		const btVector3 &	jointAxisW
	)			`[protected]`

Definition at line 439 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::buildJacobian ( ) [virtual]

performs Jacobian calculation, and also calculates angle differences and axis

Reimplemented from btTypedConstraint.

Definition at line 464 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::buildLinearJacobian	(	btJacobianEntry &	jacLinear,
		const btVector3 &	normalWorld,
		const btVector3 &	pivotAInW,
		const btVector3 &	pivotBInW
	)			`[protected]`

Definition at line 421 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::calcAnchorPos ( void ) [virtual]

Definition at line 708 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::calculateAngleInfo ( ) [protected]

calcs the euler angles between the two bodies.

Definition at line 359 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::calculateLinearInfo ( ) [protected]

Definition at line 729 of file btGeneric6DofConstraint.cpp.

SIMD_FORCE_INLINE int btGeneric6DofConstraint::calculateSerializeBufferSize ( ) const [virtual]

Reimplemented from btTypedConstraint.

Definition at line 553 of file btGeneric6DofConstraint.h.

void btGeneric6DofConstraint::calculateTransforms ( )

Definition at line 390 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::calculateTransforms	(	const btTransform &	transA,
		const btTransform &	transB
	)

Calcs global transform of the offsets.

Calcs the global transform for the joint offset for body A an B, and also calcs the agle differences between the bodies.

See also:: btGeneric6DofConstraint.getCalculatedTransformA , btGeneric6DofConstraint.getCalculatedTransformB, btGeneric6DofConstraint.calculateAngleInfo

Definition at line 395 of file btGeneric6DofConstraint.cpp.

int btGeneric6DofConstraint::get_limit_motor_info2	(	btRotationalLimitMotor *	limot,
		const btTransform &	transA,
		const btTransform &	transB,
		const btVector3 &	linVelA,
		const btVector3 &	linVelB,
		const btVector3 &	angVelA,
		const btVector3 &	angVelB,
		btConstraintInfo2 *	info,
		int	row,
		btVector3 &	ax1,
		int	rotational,
		int	rotAllowed = `false`
	)

Definition at line 742 of file btGeneric6DofConstraint.cpp.

btScalar btGeneric6DofConstraint::getAngle ( int axis_index ) const

Get the relative Euler angle.

Precondition:: btGeneric6DofConstraint::calculateTransforms() must be called previously.

Definition at line 701 of file btGeneric6DofConstraint.cpp.

btVector3 btGeneric6DofConstraint::getAxis ( int axis_index ) const

Get the rotation axis in global coordinates.

Precondition:: btGeneric6DofConstraint.buildJacobian must be called previously.

Definition at line 689 of file btGeneric6DofConstraint.cpp.

const btTransform& btGeneric6DofConstraint::getCalculatedTransformA ( ) const [inline]

Gets the global transform of the offset for body A.

See also:: btGeneric6DofConstraint.getFrameOffsetA, btGeneric6DofConstraint.getFrameOffsetB, btGeneric6DofConstraint.calculateAngleInfo.

Definition at line 368 of file btGeneric6DofConstraint.h.

const btTransform& btGeneric6DofConstraint::getCalculatedTransformB ( ) const [inline]

Gets the global transform of the offset for body B.

See also:: btGeneric6DofConstraint.getFrameOffsetA, btGeneric6DofConstraint.getFrameOffsetB, btGeneric6DofConstraint.calculateAngleInfo.

Definition at line 377 of file btGeneric6DofConstraint.h.

btTransform& btGeneric6DofConstraint::getFrameOffsetA ( ) [inline]

Definition at line 393 of file btGeneric6DofConstraint.h.

const btTransform& btGeneric6DofConstraint::getFrameOffsetA ( ) const [inline]

Definition at line 382 of file btGeneric6DofConstraint.h.

btTransform& btGeneric6DofConstraint::getFrameOffsetB ( ) [inline]

Definition at line 398 of file btGeneric6DofConstraint.h.

const btTransform& btGeneric6DofConstraint::getFrameOffsetB ( ) const [inline]

Definition at line 387 of file btGeneric6DofConstraint.h.

void btGeneric6DofConstraint::getInfo1 ( btConstraintInfo1 * info ) [virtual]

internal method used by the constraint solver, don't use them directly

Implements btTypedConstraint.

Definition at line 526 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::getInfo1NonVirtual ( btConstraintInfo1 * info )

Definition at line 560 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::getInfo2 ( btConstraintInfo2 * info ) [virtual]

internal method used by the constraint solver, don't use them directly

Implements btTypedConstraint.

Reimplemented in btGeneric6DofSpringConstraint.

Definition at line 575 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::getInfo2NonVirtual	(	btConstraintInfo2 *	info,
		const btTransform &	transA,
		const btTransform &	transB,
		const btVector3 &	linVelA,
		const btVector3 &	linVelB,
		const btVector3 &	angVelA,
		const btVector3 &	angVelB
	)

Definition at line 580 of file btGeneric6DofConstraint.cpp.

btScalar btGeneric6DofConstraint::getParam	(	int	num,
		int	axis = `-1`
	)			const `[virtual]`

return the local value of parameter

Implements btTypedConstraint.

Definition at line 964 of file btGeneric6DofConstraint.cpp.

btScalar btGeneric6DofConstraint::getRelativePivotPosition ( int axis_index ) const

Get the relative position of the constraint pivot.

Precondition:: btGeneric6DofConstraint::calculateTransforms() must be called previously.

Definition at line 695 of file btGeneric6DofConstraint.cpp.

btRotationalLimitMotor* btGeneric6DofConstraint::getRotationalLimitMotor ( int index ) [inline]

Retrieves the angular limit informacion.

Definition at line 467 of file btGeneric6DofConstraint.h.

btTranslationalLimitMotor* btGeneric6DofConstraint::getTranslationalLimitMotor ( ) [inline]

Retrieves the limit informacion.

Definition at line 473 of file btGeneric6DofConstraint.h.

bool btGeneric6DofConstraint::getUseFrameOffset ( ) [inline]

Definition at line 519 of file btGeneric6DofConstraint.h.

bool btGeneric6DofConstraint::isLimited ( int limitIndex ) [inline]

Test limit.

free means upper < lower,
locked means upper == lower
limited means upper > lower
limitIndex: first 3 are linear, next 3 are angular

Definition at line 502 of file btGeneric6DofConstraint.h.

btGeneric6DofConstraint& btGeneric6DofConstraint::operator= ( btGeneric6DofConstraint & other ) [inline, protected]

Reimplemented from btTypedConstraint.

Definition at line 321 of file btGeneric6DofConstraint.h.

SIMD_FORCE_INLINE const char * btGeneric6DofConstraint::serialize	(	void *	dataBuffer,
		btSerializer *	serializer
	)			const `[virtual]`

fills the dataBuffer and returns the struct name (and 0 on failure)

Reimplemented from btTypedConstraint.

Definition at line 559 of file btGeneric6DofConstraint.h.

int btGeneric6DofConstraint::setAngularLimits	(	btConstraintInfo2 *	info,
		int	row_offset,
		const btTransform &	transA,
		const btTransform &	transB,
		const btVector3 &	linVelA,
		const btVector3 &	linVelB,
		const btVector3 &	angVelA,
		const btVector3 &	angVelB
	)			`[protected]`

Definition at line 647 of file btGeneric6DofConstraint.cpp.

void btGeneric6DofConstraint::setAngularLowerLimit ( const btVector3 & angularLower ) [inline]

Definition at line 454 of file btGeneric6DofConstraint.h.

void btGeneric6DofConstraint::setAngularUpperLimit ( const btVector3 & angularUpper ) [inline]

Definition at line 460 of file btGeneric6DofConstraint.h.

void btGeneric6DofConstraint::setLimit	(	int	axis,
		btScalar	lo,
		btScalar	hi
	)			`[inline]`

Definition at line 479 of file btGeneric6DofConstraint.h.

int btGeneric6DofConstraint::setLinearLimits	(	btConstraintInfo2 *	info,
		int	row,
		const btTransform &	transA,
		const btTransform &	transB,
		const btVector3 &	linVelA,
		const btVector3 &	linVelB,
		const btVector3 &	angVelA,
		const btVector3 &	angVelB
	)			`[protected]`