com.jme3.bullet.collision.shapes.infos

Class ChildCollisionShape

java.lang.Object

com.jme3.bullet.collision.shapes.infos.ChildCollisionShape

public class ChildCollisionShape
extends java.lang.Object

An element in a CompoundCollisionShape, consisting of a (non-compound) base shape, offset and rotated with respect to its parent.

Despite its name, it is not a subtype of CollisionShape!

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.logging.Logger	logger message logger for this class

Constructor Summary

Constructors

Constructor and Description
ChildCollisionShape(Vector3f offset, CollisionShape shape) Instantiate a child without any rotation.
ChildCollisionShape(Vector3f offset, Matrix3f rotation, CollisionShape shape) Instantiate a child for use in a compound shape.

Method Summary

Modifier and Type	Method and Description
Vector3f	copyOffset(Vector3f storeResult) Copy the translation in the parent's coordinate system.
Quaternion	copyRotation(Quaternion storeResult) Copy the rotation in the parent's coordinate system.
Matrix3f	copyRotationMatrix(Matrix3f storeResult) Copy the rotation in the parent's coordinate system.
Transform	copyTransform(Transform storeResult) Copy the Transform relative to the parent's coordinate system.
CollisionShape	getShape() Access the base shape.
void	setTransform(Vector3f offset, Matrix3f rotation) Alter the child's coordinate transform copy.
ChildCollisionShape[]	split(Triangle parentTriangle) Attempt to divide this child into 2 children.

Methods inherited from class java.lang.Object

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

Field Detail

logger

public static final java.util.logging.Logger logger

message logger for this class

Constructor Detail

ChildCollisionShape

public ChildCollisionShape(Vector3f offset,
                           Matrix3f rotation,
                           CollisionShape shape)

Instantiate a child for use in a compound shape.

Parameters:

offset - the desired translation in the parent's coordinate system (not null, unaffected)

rotation - the desired rotation in the parent's coordinate system (not null, unaffected)

shape - the base shape (not null, not a compound shape, alias created)

ChildCollisionShape

public ChildCollisionShape(Vector3f offset,
                           CollisionShape shape)

Instantiate a child without any rotation.

Parameters:

offset - the desired translation in the parent's coordinate system (not null, unaffected)

shape - the base shape (not null, not a compound shape, alias created)

Method Detail

copyOffset

public Vector3f copyOffset(Vector3f storeResult)

Copy the translation in the parent's coordinate system.

Parameters:

storeResult - storage for the result (modified if not null)

Returns:

a translation vector (either storeResult or a new vector, not null)

copyRotation

public Quaternion copyRotation(Quaternion storeResult)

Copy the rotation in the parent's coordinate system.

Parameters:

storeResult - storage for the result (modified if not null)

Returns:

a Quaternion (either storeResult or a new Quaternion, not null)

copyRotationMatrix

public Matrix3f copyRotationMatrix(Matrix3f storeResult)

Copy the rotation in the parent's coordinate system.

Parameters:

storeResult - storage for the result (modified if not null)

Returns:

a rotation matrix (either storeResult or a new matrix, not null)

copyTransform

public Transform copyTransform(Transform storeResult)

Copy the Transform relative to the parent's coordinate system.

Parameters:

storeResult - storage for the result (modified if not null)

Returns:

a Transform with scale=1 (either storeResult or a new instance, not null)

getShape

public CollisionShape getShape()

Access the base shape.

Returns:

the pre-existing shape (not null)

setTransform

public void setTransform(Vector3f offset,
                         Matrix3f rotation)

Alter the child's coordinate transform copy. For internal use only.

Parameters:

offset - the desired translation relative to the parent (not null, unaffected)

rotation - the desired rotation relative to the parent (not null, unaffected)

See Also:

#setChildTransform(com.jme3.bullet.collision.shapes.CollisionShape, com.jme3.math.Transform)

split

public ChildCollisionShape[] split(Triangle parentTriangle)

Attempt to divide this child into 2 children. The base shape must be splittable.

Parameters:

parentTriangle - a triangle that defines the splitting plane (in parent's shape coordinates, not null, unaffected)

Returns:

a pair of children, the first element on the triangle's minus side and the 2nd element on its plus side; either element may be null, indicating an empty child