com.jme3.bullet.joints

Class ConeJoint

java.lang.Object

com.jme3.bullet.joints.PhysicsJoint

com.jme3.bullet.joints.ConeJoint

All Implemented Interfaces:

Savable

public class ConeJoint
extends PhysicsJoint

A joint based on Bullet's btConeTwistConstraint.

From the Bullet manual:
To create ragdolls, the cone twist constraint is very useful for limbs like the upper arm. It is a special point to point constraint that adds cone and twist axis limits. The x-axis serves as twist axis.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	angularOnly
protected Matrix3f	rotA
protected Matrix3f	rotB
protected float	swingSpan1
protected float	swingSpan2
protected float	twistSpan

Fields inherited from class com.jme3.bullet.joints.PhysicsJoint

collisionBetweenLinkedBodys, nodeA, nodeB, objectId, pivotA, pivotB

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ConeJoint() No-argument constructor needed by SavableClassUtil.
	ConeJoint(PhysicsRigidBody nodeA, PhysicsRigidBody nodeB, Vector3f pivotA, Vector3f pivotB) Instantiate a ConeJoint.
	ConeJoint(PhysicsRigidBody nodeA, PhysicsRigidBody nodeB, Vector3f pivotA, Vector3f pivotB, Matrix3f rotA, Matrix3f rotB) Instantiate a ConeJoint.

Method Summary

Modifier and Type	Method and Description
protected void	createJoint() Create the configured joint in Bullet.
void	read(JmeImporter im) De-serialize this joint, for example when loading from a J3O file.
void	setAngularOnly(boolean value) Alter whether this joint is angular only.
void	setLimit(float swingSpan1, float swingSpan2, float twistSpan) Alter the angular limits for this joint.
void	write(JmeExporter ex) Serialize this joint, for example when saving to a J3O file.

Methods inherited from class com.jme3.bullet.joints.PhysicsJoint

destroy, finalize, getAppliedImpulse, getBodyA, getBodyB, getObjectId, getPivotA, getPivotB, isCollisionBetweenLinkedBodys, setCollisionBetweenLinkedBodys

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

rotA

protected Matrix3f rotA

rotB

protected Matrix3f rotB

swingSpan1

protected float swingSpan1

swingSpan2

protected float swingSpan2

twistSpan

protected float twistSpan

angularOnly

protected boolean angularOnly

Constructor Detail

ConeJoint

protected ConeJoint()

No-argument constructor needed by SavableClassUtil. Do not invoke directly!

ConeJoint

public ConeJoint(PhysicsRigidBody nodeA,
                 PhysicsRigidBody nodeB,
                 Vector3f pivotA,
                 Vector3f pivotB)

Instantiate a ConeJoint. To be effective, the joint must be added to a physics space.

Parameters:

nodeA - the 1st body connected by the joint (not null, alias created)

nodeB - the 2nd body connected by the joint (not null, alias created)

pivotA - the local offset of the connection point in node A (not null, alias created)

pivotB - the local offset of the connection point in node B (not null, alias created)

ConeJoint

public ConeJoint(PhysicsRigidBody nodeA,
                 PhysicsRigidBody nodeB,
                 Vector3f pivotA,
                 Vector3f pivotB,
                 Matrix3f rotA,
                 Matrix3f rotB)

Instantiate a ConeJoint. To be effective, the joint must be added to a physics space.

Parameters:

nodeA - the 1st body connected by the joint (not null, alias created)

nodeB - the 2nd body connected by the joint (not null, alias created)

pivotA - local translation of the joint connection point in node A (not null, alias created)

pivotB - local translation of the joint connection point in node B (not null, alias created)

rotA - the local orientation of the connection to node A (not null, alias created)

rotB - the local orientation of the connection to node B (not null, alias created)

Method Detail

setLimit

public void setLimit(float swingSpan1,
                     float swingSpan2,
                     float twistSpan)

Alter the angular limits for this joint.

Parameters:

swingSpan1 - angle (in radians)

swingSpan2 - angle (in radians)

twistSpan - angle (in radians)

setAngularOnly

public void setAngularOnly(boolean value)

Alter whether this joint is angular only.

Parameters:

value - the desired setting (default=false)

write

public void write(JmeExporter ex)
           throws java.io.IOException

Serialize this joint, for example when saving to a J3O file.

Specified by:

write in interface Savable

Overrides:

write in class PhysicsJoint

Parameters:

ex - exporter (not null)

Throws:

java.io.IOException - from exporter

read

public void read(JmeImporter im)
          throws java.io.IOException

De-serialize this joint, for example when loading from a J3O file.

Specified by:

read in interface Savable

Overrides:

read in class PhysicsJoint

Parameters:

im - importer (not null)

Throws:

java.io.IOException - from importer

createJoint

protected void createJoint()

Create the configured joint in Bullet.