com.jme3.bullet.joints

Class Point2PointJoint

java.lang.Object

com.jme3.bullet.joints.PhysicsJoint

com.jme3.bullet.joints.Point2PointJoint

All Implemented Interfaces:

com.jme3.export.Savable

public class Point2PointJoint
extends PhysicsJoint

A joint based on Bullet's btPoint2PointConstraint.

From the Bullet manual:
Point to point constraint limits the translation so that the local pivot points of 2 rigidbodies match in worldspace. A chain of rigidbodies can be connected using this constraint.

Author:

normenhansen

Field Summary

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

collisionBetweenLinkedBodys, nodeA, nodeB, objectId, pivotA, pivotB

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Point2PointJoint() No-argument constructor needed by SavableClassUtil.
	Point2PointJoint(PhysicsRigidBody nodeA, PhysicsRigidBody nodeB, com.jme3.math.Vector3f pivotA, com.jme3.math.Vector3f pivotB) Instantiate a Point2PointJoint.

Method Summary

Modifier and Type	Method and Description
protected void	createJoint() Create the configured joint in Bullet.
float	getDamping() Read the joint's damping ratio.
float	getImpulseClamp() Read the joint's impulse clamp.
float	getTau() Read the joint's tau value.
void	read(com.jme3.export.JmeImporter im) De-serialize this joint, for example when loading from a J3O file.
void	setDamping(float value) Alter the joint's damping.
void	setImpulseClamp(float value) Alter the joint's impulse clamp.
void	setTau(float value) Alter the joint's tau value.
void	write(com.jme3.export.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

Constructor Detail

Point2PointJoint

protected Point2PointJoint()

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

Point2PointJoint

public Point2PointJoint(PhysicsRigidBody nodeA,
                        PhysicsRigidBody nodeB,
                        com.jme3.math.Vector3f pivotA,
                        com.jme3.math.Vector3f pivotB)

Instantiate a Point2PointJoint. 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)

Method Detail

setDamping

public void setDamping(float value)

Alter the joint's damping.

Parameters:

value - the desired viscous damping ratio (0→no damping, 1→critically damped, default=1)

setImpulseClamp

public void setImpulseClamp(float value)

Alter the joint's impulse clamp.

Parameters:

value - the desired impulse clamp value (default=0)

setTau

public void setTau(float value)

Alter the joint's tau value.

Parameters:

value - the desired tau value (default=0.3)

getDamping

public float getDamping()

Read the joint's damping ratio.

Returns:

the viscous damping ratio (0→no damping, 1→critically damped)

getImpulseClamp

public float getImpulseClamp()

Read the joint's impulse clamp.

Returns:

the clamp value

getTau

public float getTau()

Read the joint's tau value.

Returns:

the tau value

write

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

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

Specified by:

write in interface com.jme3.export.Savable

Overrides:

write in class PhysicsJoint

Parameters:

ex - exporter (not null)

Throws:

java.io.IOException - from exporter

read

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

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

Specified by:

read in interface com.jme3.export.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.