com.jme3.bullet.control

Class AbstractPhysicsControl

java.lang.Object

com.jme3.bullet.control.AbstractPhysicsControl

All Implemented Interfaces:

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

Direct Known Subclasses:

BetterCharacterControl, KinematicRagdollControl

public abstract class AbstractPhysicsControl
extends java.lang.Object
implements PhysicsControl, com.jme3.util.clone.JmeCloneable

AbstractPhysicsControl manages the lifecycle of a physics object that is attached to a spatial in the SceneGraph.

Author:

normenhansen

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	added
protected boolean	applyLocal
protected boolean	enabled
protected PhysicsSpace	space
protected com.jme3.scene.Spatial	spatial

Constructor Summary

Constructors

Constructor and Description
AbstractPhysicsControl()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract void	addPhysics(PhysicsSpace space) Called when the physics object is supposed to add all objects it needs to manage to the physics space.
protected void	applyPhysicsTransform(com.jme3.math.Vector3f worldLocation, com.jme3.math.Quaternion worldRotation) Applies a physics transform to the spatial
void	cloneFields(com.jme3.util.clone.Cloner cloner, java.lang.Object original)
protected abstract void	createSpatialData(com.jme3.scene.Spatial spat) Called when the control is added to a new spatial, create any spatial-dependent data here.
PhysicsSpace	getPhysicsSpace()
protected com.jme3.math.Quaternion	getSpatialRotation()
protected com.jme3.math.Vector3f	getSpatialTranslation()
boolean	isApplyPhysicsLocal()
boolean	isEnabled() Returns the current enabled state of the physics control
void	read(com.jme3.export.JmeImporter im)
protected abstract void	removePhysics(PhysicsSpace space) Called when the physics object is supposed to remove all objects added to the physics space.
protected abstract void	removeSpatialData(com.jme3.scene.Spatial spat) Called when the control is removed from a spatial, remove any spatial-dependent data here.
void	render(com.jme3.renderer.RenderManager rm, com.jme3.renderer.ViewPort vp)
void	setApplyPhysicsLocal(boolean applyPhysicsLocal) When set to true, the physics coordinates will be applied to the local translation of the Spatial
void	setEnabled(boolean enabled) The physics object is removed from the physics space when the control is disabled.
protected abstract void	setPhysicsLocation(com.jme3.math.Vector3f vec) Called when the physics object is supposed to move to the spatial position.
protected abstract void	setPhysicsRotation(com.jme3.math.Quaternion quat) Called when the physics object is supposed to move to the spatial rotation.
void	setPhysicsSpace(PhysicsSpace space) Only used internally, do not call.
void	setSpatial(com.jme3.scene.Spatial spatial)
void	update(float tpf)
void	write(com.jme3.export.JmeExporter ex)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.jme3.scene.control.Control

cloneForSpatial

Methods inherited from interface com.jme3.util.clone.JmeCloneable

jmeClone

Field Detail

spatial

protected com.jme3.scene.Spatial spatial

enabled

protected boolean enabled

added

protected boolean added

space

protected PhysicsSpace space

applyLocal

protected boolean applyLocal

Constructor Detail

AbstractPhysicsControl

public AbstractPhysicsControl()

Method Detail

createSpatialData

protected abstract void createSpatialData(com.jme3.scene.Spatial spat)

Called when the control is added to a new spatial, create any spatial-dependent data here.

Parameters:

spat - The new spatial, guaranteed not to be null

removeSpatialData

protected abstract void removeSpatialData(com.jme3.scene.Spatial spat)

Called when the control is removed from a spatial, remove any spatial-dependent data here.

Parameters:

spat - The old spatial, guaranteed not to be null

setPhysicsLocation

protected abstract void setPhysicsLocation(com.jme3.math.Vector3f vec)

Called when the physics object is supposed to move to the spatial position.

Parameters:

vec -

setPhysicsRotation

protected abstract void setPhysicsRotation(com.jme3.math.Quaternion quat)

Called when the physics object is supposed to move to the spatial rotation.

Parameters:

quat -

addPhysics

protected abstract void addPhysics(PhysicsSpace space)

Called when the physics object is supposed to add all objects it needs to manage to the physics space.

Parameters:

space -

removePhysics

protected abstract void removePhysics(PhysicsSpace space)

Called when the physics object is supposed to remove all objects added to the physics space.

Parameters:

space -

isApplyPhysicsLocal

public boolean isApplyPhysicsLocal()

setApplyPhysicsLocal

public void setApplyPhysicsLocal(boolean applyPhysicsLocal)

When set to true, the physics coordinates will be applied to the local translation of the Spatial

Parameters:

applyPhysicsLocal -

getSpatialTranslation

protected com.jme3.math.Vector3f getSpatialTranslation()

getSpatialRotation

protected com.jme3.math.Quaternion getSpatialRotation()

applyPhysicsTransform

protected void applyPhysicsTransform(com.jme3.math.Vector3f worldLocation,
                         com.jme3.math.Quaternion worldRotation)

Applies a physics transform to the spatial

Parameters:

worldLocation -

worldRotation -

cloneFields

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

Specified by:

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

setSpatial

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

Specified by:

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

setEnabled

public void setEnabled(boolean enabled)

Description copied from interface: PhysicsControl

The physics object is removed from the physics space when the control is disabled. When the control is enabled again the physics object is moved to the current location of the spatial and then added to the physics space. This allows disabling/enabling physics to move the spatial freely.

Specified by:

setEnabled in interface PhysicsControl

isEnabled

public boolean isEnabled()

Description copied from interface: PhysicsControl

Returns the current enabled state of the physics control

Specified by:

isEnabled in interface PhysicsControl

Returns:

current enabled state

update

public void update(float tpf)

Specified by:

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

render

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

Specified by:

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

setPhysicsSpace

public void setPhysicsSpace(PhysicsSpace space)

Description copied from interface: PhysicsControl

Only used internally, do not call.

Specified by:

setPhysicsSpace in interface PhysicsControl

getPhysicsSpace

public PhysicsSpace getPhysicsSpace()

Specified by:

getPhysicsSpace in interface PhysicsControl

write

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

Specified by:

write in interface com.jme3.export.Savable

Throws:

java.io.IOException

read

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

Specified by:

read in interface com.jme3.export.Savable

Throws:

java.io.IOException