com.jme3.bullet.control

Class CharacterControl

java.lang.Object

com.jme3.bullet.collision.PhysicsCollisionObject

com.jme3.bullet.objects.PhysicsCharacter

com.jme3.bullet.control.CharacterControl

All Implemented Interfaces:

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

public class CharacterControl
extends PhysicsCharacter
implements PhysicsControl, com.jme3.util.clone.JmeCloneable

You might want to try BetterCharacterControl as well.

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
protected boolean	useViewDirection
protected com.jme3.math.Vector3f	viewDirection

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

characterId, fallSpeed, jumpSpeed, locationDirty, stepHeight, tmp_inverseWorldRotation, upAxis, walkDirection

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, objectId

Constructor Summary

Constructors

Constructor and Description
CharacterControl()
CharacterControl(CollisionShape shape, float stepHeight)

Method Summary

Modifier and Type	Method and Description
void	cloneFields(com.jme3.util.clone.Cloner cloner, java.lang.Object original)
com.jme3.scene.control.Control	cloneForSpatial(com.jme3.scene.Spatial spatial) Deprecated.
PhysicsSpace	getPhysicsSpace() Access the physics space to which the object is (or would be) added.
com.jme3.scene.Spatial	getSpatial()
com.jme3.math.Vector3f	getViewDirection()
boolean	isApplyPhysicsLocal()
boolean	isEnabled() Test whether this control is enabled.
boolean	isUseViewDirection()
java.lang.Object	jmeClone()
void	read(com.jme3.export.JmeImporter im) De-serialize this character from the specified importer, for example when loading from a J3O file.
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) 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)
void	setUseViewDirection(boolean viewDirectionEnabled)
void	setViewDirection(com.jme3.math.Vector3f vec)
void	update(float tpf)
void	write(com.jme3.export.JmeExporter ex) Serialize this character, for example when saving to a J3O file.

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

buildObject, destroy, finalize, getAngularDamping, getAngularVelocity, getCcdMotionThreshold, getCcdSquareMotionThreshold, getCcdSweptSphereRadius, getControllerId, getFallSpeed, getGravity, getGravity, getJumpSpeed, getLinearDamping, getLinearVelocity, getMaxPenetrationDepth, getMaxSlope, getPhysicsLocation, getPhysicsLocation, getStepHeight, getUpAxis, getWalkDirection, jump, jump, onGround, setAngularDamping, setAngularVelocity, setCcdMotionThreshold, setCcdSweptSphereRadius, setCollisionShape, setContactResponse, setFallSpeed, setGravity, setGravity, setJumpSpeed, setLinearDamping, setLinearVelocity, setMaxPenetrationDepth, setMaxSlope, setPhysicsLocation, setStepHeight, setUp, setUpAxis, setWalkDirection, warp

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

addCollideWithGroup, attachCollisionShape, finalizeNative, getCollideWithGroups, getCollisionFlags, getCollisionGroup, getCollisionShape, getDeactivationTime, getObjectId, getUserObject, initUserPointer, isContactResponse, removeCollideWithGroup, setCollideWithGroups, setCollisionFlags, setCollisionGroup, setUserObject

Methods inherited from class java.lang.Object

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

Field Detail

spatial

protected com.jme3.scene.Spatial spatial

enabled

protected boolean enabled

added

protected boolean added

space

protected PhysicsSpace space

viewDirection

protected com.jme3.math.Vector3f viewDirection

useViewDirection

protected boolean useViewDirection

applyLocal

protected boolean applyLocal

Constructor Detail

CharacterControl

public CharacterControl()

CharacterControl

public CharacterControl(CollisionShape shape,
                        float stepHeight)

Method Detail

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 -

cloneForSpatial

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

Deprecated.

Specified by:

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

jmeClone

public java.lang.Object jmeClone()

Specified by:

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

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

getSpatial

public com.jme3.scene.Spatial getSpatial()

Returns:

returns the spatial the control is added to, or null if the control is not attached to a spatial yet.

setEnabled

public void setEnabled(boolean enabled)

Description copied from interface: PhysicsControl

Enable or disable this control.

The physics object is removed from its 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.

Specified by:

setEnabled in interface PhysicsControl

Parameters:

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

isEnabled

public boolean isEnabled()

Description copied from interface: PhysicsControl

Test whether this control is enabled.

Specified by:

isEnabled in interface PhysicsControl

Returns:

true if enabled, otherwise false

setViewDirection

public void setViewDirection(com.jme3.math.Vector3f vec)

getViewDirection

public com.jme3.math.Vector3f getViewDirection()

isUseViewDirection

public boolean isUseViewDirection()

setUseViewDirection

public void setUseViewDirection(boolean viewDirectionEnabled)

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 newSpace)

If enabled, add this control's physics object to the specified physics space. If 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()

Description copied from interface: PhysicsControl

Access the physics space to which the object 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

Description copied from class: PhysicsCharacter

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

Specified by:

write in interface com.jme3.export.Savable

Overrides:

write in class PhysicsCharacter

Parameters:

ex - exporter (not null)

Throws:

java.io.IOException - from exporter

read

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

Description copied from class: PhysicsCharacter

De-serialize this character from the specified importer, for example when loading from a J3O file.

Specified by:

read in interface com.jme3.export.Savable

Overrides:

read in class PhysicsCharacter

Parameters:

im - importer (not null)

Throws:

java.io.IOException - from importer