Module com.github.stephengold.joltjni

Package com.github.stephengold.joltjni

Class SubShape

java.lang.Object

com.github.stephengold.joltjni.JoltPhysicsObject

com.github.stephengold.joltjni.SubShape

All Implemented Interfaces:

ConstJoltPhysicsObject, ConstSubShape, AutoCloseable, Comparable<JoltPhysicsObject>

public class SubShape
extends JoltPhysicsObject
implements ConstSubShape

An element of a compound shape. (native type: CompoundShape::SubShape)

Method Summary

Modifier and Type	Method	Description
Mat44	getLocalTransformNoScale(Vec3Arg scale)	Calculate the local transform for this shape, given the scale of the child.
Vec3	getPositionCom()	Copy the center-of-mass location.
void	getPositionCom(Vec3 storeResult)	Copy the center-of-mass location.
Quat	getRotation()	Copy the rotation.
void	getRotation(Quat storeResult)	Copy the rotation.
ConstShape	getShape()	Access the child shape.
boolean	isValidScale(Vec3Arg scale)	Test whether the specified scale is valid for the sub-shape.
void	setPositionCom(float x, float y, float z)	Alter the center-of-mass location.
void	setPositionCom(Vec3Arg location)	Alter the center-of-mass location.
void	setRotation(float qx, float qy, float qz, float qw)	Alter the rotation.
void	setRotation(QuatArg rotation)	Alter the rotation.
void	setTransform(Vec3Arg offset, QuatArg rotation, Vec3Arg centerOfMass)	Alter the coordinate transform.
Vec3	transformScale(Vec3Arg scale)	Transform the specified scale to the local space of the child.

Methods inherited from class com.github.stephengold.joltjni.JoltPhysicsObject

close, compareTo, equals, getContainingObject, hasAssignedNativeObject, hashCode, isCleanerStarted, ownsNativeObject, setVirtualAddress, setVirtualAddress, startCleaner, targetVa, targetVaOrZero, toString, va

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface com.github.stephengold.joltjni.readonly.ConstJoltPhysicsObject

close, hasAssignedNativeObject, ownsNativeObject, targetVa, targetVaOrZero

Method Details

setPositionCom

public void setPositionCom(float x,
 float y,
 float z)

Alter the center-of-mass location. (native function: SetPositionCOM)

Parameters:

x - the desired X coordinate of the center of mass

y - the desired Y coordinate of the center of mass

z - the desired Z coordinate of the center of mass

setPositionCom

public void setPositionCom(Vec3Arg location)

Alter the center-of-mass location. (native function: SetPositionCOM)

Parameters:

location - the desired location (not null, unaffected)

setRotation

public void setRotation(float qx,
 float qy,
 float qz,
 float qw)

Alter the rotation.

Parameters:

qx - the X component of the desired rotation

qy - the Y component of the desired rotation

qz - the Z component of the desired rotation

qw - the W component of the desired rotation

setRotation

public void setRotation(QuatArg rotation)

Alter the rotation.

Parameters:

rotation - the desired rotation (not null, unaffected)

setTransform

public void setTransform(Vec3Arg offset,
 QuatArg rotation,
 Vec3Arg centerOfMass)

Alter the coordinate transform.

Parameters:

offset - the desired translation (not null, unaffected)

rotation - the desired rotation (not null, unaffected)

centerOfMass - the desired center of mass (not null, unaffected)

getLocalTransformNoScale

public Mat44 getLocalTransformNoScale(Vec3Arg scale)

Calculate the local transform for this shape, given the scale of the child. The sub-shape is unaffected.

Specified by:

getLocalTransformNoScale in interface ConstSubShape

Parameters:

scale - the scale of the child in the local space of this shape (not null, unaffected)

Returns:

a new transform matrix

getPositionCom

public Vec3 getPositionCom()

Copy the center-of-mass location. The sub-shape is unaffected. (native function: GetPositionCOM)

Specified by:

getPositionCom in interface ConstSubShape

Returns:

a new vector

getPositionCom

public void getPositionCom(Vec3 storeResult)

Copy the center-of-mass location. The sub-shape is unaffected. (native function: GetPositionCOM)

Specified by:

getPositionCom in interface ConstSubShape

Parameters:

storeResult - storage for the location (not null, modified)

getRotation

public Quat getRotation()

Copy the rotation. The sub-shape is unaffected.

Specified by:

getRotation in interface ConstSubShape

Returns:

a new rotation quaternion

getRotation

public void getRotation(Quat storeResult)

Copy the rotation. The sub-shape is unaffected.

Specified by:

getRotation in interface ConstSubShape

Parameters:

storeResult - storage for the rotation (not null, modified)

getShape

public ConstShape getShape()

Access the child shape. The sub-shape is unaffected. (native field: mShape)

Specified by:

getShape in interface ConstSubShape

Returns:

a new JVM object with the pre-existing native object assigned

isValidScale

public boolean isValidScale(Vec3Arg scale)

Test whether the specified scale is valid for the sub-shape. The sub-shape is unaffected.

Specified by:

isValidScale in interface ConstSubShape

Parameters:

scale - the scale factors to validate (not null, unaffected)

Returns:

true if valid, otherwise false

transformScale

public Vec3 transformScale(Vec3Arg scale)

Transform the specified scale to the local space of the child. The sub-shape is unaffected.

Specified by:

transformScale in interface ConstSubShape

Parameters:

scale - the scale to transform (not null, unaffected)

Returns:

a new vector