com.jme3.bullet.control

Class VehicleControl

java.lang.Object

com.jme3.bullet.collision.PhysicsCollisionObject

com.jme3.bullet.objects.PhysicsRigidBody

com.jme3.bullet.objects.PhysicsVehicle

com.jme3.bullet.control.VehicleControl

All Implemented Interfaces:

PhysicsControl, com.jme3.export.Savable, com.jme3.scene.control.Control, com.jme3.util.clone.JmeCloneable, java.lang.Cloneable

public class VehicleControl
extends PhysicsVehicle
implements PhysicsControl, com.jme3.util.clone.JmeCloneable

A physics control to link a PhysicsVehicle to a spatial.

This class is shared between JBullet and Native Bullet.

Author:

normenhansen

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	added true→vehicle is added to the physics space, false→not added
protected boolean	enabled true→control is enabled, false→control is disabled
protected PhysicsSpace	space space to which the vehicle is (or would be) added
protected com.jme3.scene.Spatial	spatial spatial to which this control is added, or null if none

Fields inherited from class com.jme3.bullet.objects.PhysicsVehicle

physicsSpace, rayCaster, tuning, vehicle, wheels

Fields inherited from class com.jme3.bullet.objects.PhysicsRigidBody

constructionInfo, joints, kinematic, localInertia, mass, motionState, rBody, tempMatrix, tempTrans, tempVec, tempVec2

Fields inherited from class com.jme3.bullet.collision.PhysicsCollisionObject

COLLISION_GROUP_01, COLLISION_GROUP_02, COLLISION_GROUP_03, COLLISION_GROUP_04, COLLISION_GROUP_05, COLLISION_GROUP_06, COLLISION_GROUP_07, COLLISION_GROUP_08, COLLISION_GROUP_09, COLLISION_GROUP_10, COLLISION_GROUP_11, COLLISION_GROUP_12, COLLISION_GROUP_13, COLLISION_GROUP_14, COLLISION_GROUP_15, COLLISION_GROUP_16, COLLISION_GROUP_NONE, collisionGroup, collisionGroupsMask, collisionShape

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	VehicleControl() No-argument constructor needed by SavableClassUtil.
	VehicleControl(CollisionShape shape) Instantiate an enabled control with mass=1 and the specified collision shape.
	VehicleControl(CollisionShape shape, float mass) Instantiate an enabled with the specified collision shape and mass.

Method Summary

Modifier and Type	Method and Description
void	cloneFields(com.jme3.util.clone.Cloner cloner, java.lang.Object original) Callback from Cloner to convert this shallow-cloned control into a deep-cloned one, using the specified cloner and original to resolve copied fields.
com.jme3.scene.control.Control	cloneForSpatial(com.jme3.scene.Spatial spatial) Clone this control for a different spatial.
PhysicsSpace	getPhysicsSpace() Access the physics space to which the vehicle is (or would be) added.
boolean	isApplyPhysicsLocal() Test whether physics-space coordinates should match the spatial's local coordinates.
boolean	isEnabled() Test whether this control is enabled.
java.lang.Object	jmeClone() Create a shallow clone for the JME cloner.
void	read(com.jme3.export.JmeImporter im) De-serialize this control, for example when loading from a J3O file.
void	render(com.jme3.renderer.RenderManager rm, com.jme3.renderer.ViewPort vp) Render this control.
void	setApplyPhysicsLocal(boolean applyPhysicsLocal) Alter whether physics-space coordinates should match the spatial's local coordinates.
void	setEnabled(boolean enabled) Enable or disable this control.
void	setPhysicsSpace(PhysicsSpace newSpace) If enabled, add this control's physics object to the specified physics space.
void	setSpatial(com.jme3.scene.Spatial spatial) Alter which spatial is controlled.
void	update(float tpf) Update this control.
void	write(com.jme3.export.JmeExporter ex) Serialize this control, for example when saving to a J3O file.

Methods inherited from class com.jme3.bullet.objects.PhysicsVehicle

accelerate, accelerate, addWheel, addWheel, applyWheelTransforms, brake, brake, createVehicle, destroy, getCurrentVehicleSpeedKmHour, getForwardVector, getFrictionSlip, getMaxSuspensionForce, getMaxSuspensionTravelCm, getNumWheels, getSuspensionCompression, getSuspensionDamping, getSuspensionStiffness, getVehicleId, getWheel, postRebuild, removeWheel, resetSuspension, setFrictionSlip, setFrictionSlip, setMaxSuspensionForce, setMaxSuspensionForce, setMaxSuspensionTravelCm, setMaxSuspensionTravelCm, setRollInfluence, setSuspensionCompression, setSuspensionCompression, setSuspensionDamping, setSuspensionDamping, setSuspensionStiffness, setSuspensionStiffness, steer, steer, updateWheels

Methods inherited from class com.jme3.bullet.objects.PhysicsRigidBody

activate, addJoint, applyCentralForce, applyForce, applyImpulse, applyTorque, applyTorqueImpulse, clearForces, getAngularDamping, getAngularFactor, getAngularSleepingThreshold, getAngularVelocity, getAngularVelocity, getCcdMotionThreshold, getCcdSquareMotionThreshold, getCcdSweptSphereRadius, getFriction, getGravity, getGravity, getInterpolatedPhysicsLocation, getInterpolatedPhysicsRotation, getJoints, getLinearDamping, getLinearSleepingThreshold, getLinearVelocity, getLinearVelocity, getMass, getMotionState, getObjectId, getPhysicsLocation, getPhysicsLocation, getPhysicsRotation, getPhysicsRotation, getPhysicsRotationMatrix, getPhysicsRotationMatrix, getRestitution, isActive, isContactResponse, isKinematic, preRebuild, rebuildRigidBody, removeJoint, setAngularDamping, setAngularFactor, setAngularSleepingThreshold, setAngularVelocity, setCcdMotionThreshold, setCcdSweptSphereRadius, setCollisionShape, setContactResponse, setDamping, setFriction, setGravity, setKinematic, setLinearDamping, setLinearSleepingThreshold, setLinearVelocity, setMass, setPhysicsLocation, setPhysicsRotation, setPhysicsRotation, setRestitution, setSleepingThresholds

Methods inherited from class com.jme3.bullet.collision.PhysicsCollisionObject

addCollideWithGroup, getCollideWithGroups, getCollisionGroup, getCollisionShape, getUserObject, removeCollideWithGroup, setCollideWithGroups, setCollisionGroup, setUserObject

Methods inherited from class java.lang.Object

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

Field Detail

spatial

protected com.jme3.scene.Spatial spatial

spatial to which this control is added, or null if none

enabled

protected boolean enabled

true→control is enabled, false→control is disabled

space

protected PhysicsSpace space

space to which the vehicle is (or would be) added

added

protected boolean added

true→vehicle is added to the physics space, false→not added

Constructor Detail

VehicleControl

protected VehicleControl()

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

VehicleControl

public VehicleControl(CollisionShape shape)

Instantiate an enabled control with mass=1 and the specified collision shape.

Parameters:

shape - the desired shape (not null, alias created)

VehicleControl

public VehicleControl(CollisionShape shape,
                      float mass)

Instantiate an enabled with the specified collision shape and mass.

Parameters:

shape - the desired shape (not null, alias created)

mass - (>0)

Method Detail

isApplyPhysicsLocal

public boolean isApplyPhysicsLocal()

Test whether physics-space coordinates should match the spatial's local coordinates.

Returns:

true if matching local coordinates, false if matching world coordinates

setApplyPhysicsLocal

public void setApplyPhysicsLocal(boolean applyPhysicsLocal)

Alter whether physics-space coordinates should match the spatial's local coordinates.

Parameters:

applyPhysicsLocal - true→match local coordinates, false→match world coordinates (default=false)

cloneForSpatial

public com.jme3.scene.control.Control cloneForSpatial(com.jme3.scene.Spatial spatial)

Clone this control for a different spatial. No longer used as of JME 3.1.

Specified by:

cloneForSpatial in interface com.jme3.scene.control.Control

Parameters:

spatial - the spatial for the clone to control (or null)

Returns:

a new control (not null)

jmeClone

public java.lang.Object jmeClone()

Create a shallow clone for the JME cloner.

Specified by:

jmeClone in interface com.jme3.util.clone.JmeCloneable

Returns:

a new control (not null)

cloneFields

public void cloneFields(com.jme3.util.clone.Cloner cloner,
                        java.lang.Object original)

Callback from Cloner to convert this shallow-cloned control into a deep-cloned one, using the specified cloner and original to resolve copied fields.

Specified by:

cloneFields in interface com.jme3.util.clone.JmeCloneable

Parameters:

cloner - the cloner that's cloning this control (not null)

original - the control from which this control was shallow-cloned (unused)

setSpatial

public void setSpatial(com.jme3.scene.Spatial spatial)

Alter which spatial is controlled.

Specified by:

setSpatial in interface com.jme3.scene.control.Control

Parameters:

spatial - spatial to control (or null)

setEnabled

public void setEnabled(boolean enabled)

Enable or disable this control.

When the control is disabled, the vehicle is removed from physics space. When the control is enabled again, the physics object is moved to the spatial's location and then added to the physics space.

Specified by:

setEnabled in interface PhysicsControl

Parameters:

enabled - true→enable the control, false→disable it

isEnabled

public boolean isEnabled()

Test whether this control is enabled.

Specified by:

isEnabled in interface PhysicsControl

Returns:

true if enabled, otherwise false

update

public void update(float tpf)

Update this control. Invoked once per frame, during the logical-state update, provided the control is added to a scene.

Specified by:

update in interface com.jme3.scene.control.Control

Parameters:

tpf - the time interval between frames (in seconds, ≥0)

render

public void render(com.jme3.renderer.RenderManager rm,
                   com.jme3.renderer.ViewPort vp)

Render this control. Invoked once per view port per frame, provided the control is added to a scene. Should be invoked only by a subclass or by the RenderManager.

Specified by:

render in interface com.jme3.scene.control.Control

Parameters:

rm - the render manager (not null)

vp - the view port to render (not null)

setPhysicsSpace

public void setPhysicsSpace(PhysicsSpace newSpace)

If enabled, add this control's physics object to the specified physics space. In not enabled, alter where the object would be added. The object is removed from any other space it's currently in.

Specified by:

setPhysicsSpace in interface PhysicsControl

Parameters:

newSpace - where to add, or null to simply remove

getPhysicsSpace

public PhysicsSpace getPhysicsSpace()

Access the physics space to which the vehicle is (or would be) added.

Specified by:

getPhysicsSpace in interface PhysicsControl

Returns:

the pre-existing space, or null for none

write

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

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

Specified by:

write in interface com.jme3.export.Savable

Overrides:

write in class PhysicsVehicle

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 control, for example when loading from a J3O file.

Specified by:

read in interface com.jme3.export.Savable

Overrides:

read in class PhysicsVehicle

Parameters:

im - importer (not null)

Throws:

java.io.IOException - from importer