com.jme3.anim

Class AnimComposer

java.lang.Object

com.jme3.scene.control.AbstractControl

com.jme3.anim.AnimComposer

All Implemented Interfaces:

Savable, Control, JmeCloneable, java.lang.Cloneable

public class AnimComposer
extends AbstractControl

AnimComposer is a Spatial control that allows manipulation of armature (skeletal) animation.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_LAYER The name of the default layer.

Fields inherited from class com.jme3.scene.control.AbstractControl

enabled, spatial

Constructor Summary

Constructors

Constructor and Description
AnimComposer()

Method Summary

Modifier and Type	Method and Description
Action	action(java.lang.String name)
BlendAction	actionBlended(java.lang.String name, BlendSpace blendSpace, java.lang.String... clips) Creates an action that blends the named clips using the given blend space.
BaseAction	actionSequence(java.lang.String name, Tween... tweens) Creates an action that will interpolate over an entire sequence of tweens in order.
void	addAction(java.lang.String name, Action action) Register given action with specified name.
void	addAnimClip(AnimClip anim) Adds an animation to be available for playing to this AnimControl.
void	cloneFields(Cloner cloner, java.lang.Object original) Implemented to perform deep cloning for this object, resolving local cloned references using the specified cloner.
protected void	controlRender(RenderManager rm, ViewPort vp) To be implemented in subclass.
protected void	controlUpdate(float tpf) To be implemented in subclass.
Action	getAction(java.lang.String name)
AnimClip	getAnimClip(java.lang.String name) Retrieve an animation from the list of animations.
java.util.Collection<AnimClip>	getAnimClips() Returns an unmodifiable collection of all available animations.
java.util.Set<java.lang.String>	getAnimClipsNames() Returns an unmodifiable set of all available animation names.
Action	getCurrentAction() Return the current action on the default layer.
Action	getCurrentAction(java.lang.String layerName) Return current action on specified layer.
float	getGlobalSpeed()
double	getTime() Returns current time of the default layer.
double	getTime(java.lang.String layerName) Returns current time of the specified layer.
boolean	hasAction(java.lang.String name) Tells if an action is contained in the list of actions.
boolean	hasAnimClip(java.lang.String name) Tells if an animation is contained in the list of animations.
java.lang.Object	jmeClone() Performs a regular shallow clone of the object.
Action	makeAction(java.lang.String name) Create a new ClipAction with specified clip name.
void	makeLayer(java.lang.String name, AnimationMask mask)
void	read(JmeImporter im)
Action	removeAction(java.lang.String name) Remove specified action.
void	removeAnimClip(AnimClip anim) Remove an animation so that it is no longer available for playing.
void	removeCurrentAction() Remove current action on default layer.
void	removeCurrentAction(java.lang.String layerName) Remove current action on specified layer.
void	removeLayer(java.lang.String name) Remove specified layer.
void	reset()
Action	setCurrentAction(java.lang.String name) Run an action on the default layer.
Action	setCurrentAction(java.lang.String actionName, java.lang.String layerName) Run an action on specified layer.
void	setGlobalSpeed(float globalSpeed)
void	setTime(double time) Sets current time on the default layer.
void	setTime(java.lang.String layerName, double time) Sets current time on the specified layer.
void	write(JmeExporter ex)

Methods inherited from class com.jme3.scene.control.AbstractControl

cloneForSpatial, getSpatial, isEnabled, render, setEnabled, setSpatial, update

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_LAYER

public static final java.lang.String DEFAULT_LAYER

The name of the default layer.

See Also:

Constant Field Values

Constructor Detail

AnimComposer

public AnimComposer()

Method Detail

hasAnimClip

public boolean hasAnimClip(java.lang.String name)

Tells if an animation is contained in the list of animations.

Parameters:

name - The name of the animation.

Returns:

true, if the named animation is in the list of animations.

getAnimClip

public AnimClip getAnimClip(java.lang.String name)

Retrieve an animation from the list of animations.

Parameters:

name - The name of the animation to retrieve.

Returns:

The animation corresponding to the given name, or null, if no such named animation exists.

addAnimClip

public void addAnimClip(AnimClip anim)

Adds an animation to be available for playing to this AnimControl.

Parameters:

anim - The animation to add.

removeAnimClip

public void removeAnimClip(AnimClip anim)

Remove an animation so that it is no longer available for playing.

Parameters:

anim - The animation to remove.

setCurrentAction

public Action setCurrentAction(java.lang.String name)

Run an action on the default layer.

Parameters:

name - The name of the action to run.

Returns:

The action corresponding to the given name.

setCurrentAction

public Action setCurrentAction(java.lang.String actionName,
                               java.lang.String layerName)

Run an action on specified layer.

Parameters:

actionName - The name of the action to run.

layerName - The layer on which action should run.

Returns:

The action corresponding to the given name.

getCurrentAction

public Action getCurrentAction()

Return the current action on the default layer.

Returns:

The action corresponding to the given name.

getCurrentAction

public Action getCurrentAction(java.lang.String layerName)

Return current action on specified layer.

Parameters:

layerName - The layer on which action should run.

Returns:

The action corresponding to the given name.

removeCurrentAction

public void removeCurrentAction()

Remove current action on default layer.

removeCurrentAction

public void removeCurrentAction(java.lang.String layerName)

Remove current action on specified layer.

Parameters:

layerName - The name of the layer we want to remove its action.

getTime

public double getTime()

Returns current time of the default layer.

Returns:

The current time.

getTime

public double getTime(java.lang.String layerName)

Returns current time of the specified layer.

Parameters:

layerName - The layer from which to get the time.

Returns:

the time (in seconds)

setTime

public void setTime(double time)

Sets current time on the default layer.

Parameters:

time - the desired time (in seconds)

setTime

public void setTime(java.lang.String layerName,
                    double time)

Sets current time on the specified layer.

Parameters:

layerName - the name of the Layer to modify

time - the desired time (in seconds)

action

public Action action(java.lang.String name)

Parameters:

name - The name of the action to return.

Returns:

The action registered with specified name. It will make a new action if there isn't any.

See Also:

makeAction(java.lang.String)

getAction

public Action getAction(java.lang.String name)

Parameters:

name - The name of the action to return.

Returns:

The action registered with specified name or null if nothing is registered.

addAction

public void addAction(java.lang.String name,
                      Action action)

Register given action with specified name.

Parameters:

name - The name of the action.

action - The action to add.

makeAction

public Action makeAction(java.lang.String name)

Create a new ClipAction with specified clip name.

Parameters:

name - The name of the clip.

Returns:

a new action

Throws:

java.lang.IllegalArgumentException - if clip with specified name not found.

hasAction

public boolean hasAction(java.lang.String name)

Tells if an action is contained in the list of actions.

Parameters:

name - The name of the action.

Returns:

true, if the named action is in the list of actions.

removeAction

public Action removeAction(java.lang.String name)

Remove specified action.

Parameters:

name - The name of the action to remove.

Returns:

The removed action.

makeLayer

public void makeLayer(java.lang.String name,
                      AnimationMask mask)

removeLayer

public void removeLayer(java.lang.String name)

Remove specified layer. This will stop the current action on this layer.

Parameters:

name - The name of the layer to remove.

actionSequence

public BaseAction actionSequence(java.lang.String name,
                                 Tween... tweens)

Creates an action that will interpolate over an entire sequence of tweens in order.

Parameters:

name - a name for the new Action

tweens - the desired sequence of tweens

Returns:

a new instance

actionBlended

public BlendAction actionBlended(java.lang.String name,
                                 BlendSpace blendSpace,
                                 java.lang.String... clips)

Creates an action that blends the named clips using the given blend space.

Parameters:

name - a name for the new Action

blendSpace - how to blend the clips (not null, alias created)

clips - the names of the clips to be used (not null)

Returns:

a new instance

reset

public void reset()

getAnimClips

public java.util.Collection<AnimClip> getAnimClips()

Returns an unmodifiable collection of all available animations. When an attempt is made to modify the collection, an UnsupportedOperationException is thrown.

Returns:

the unmodifiable collection of animations

getAnimClipsNames

public java.util.Set<java.lang.String> getAnimClipsNames()

Returns an unmodifiable set of all available animation names. When an attempt is made to modify the set, an UnsupportedOperationException is thrown.

Returns:

the unmodifiable set of animation names.

controlUpdate

protected void controlUpdate(float tpf)

Description copied from class: AbstractControl

To be implemented in subclass.

Specified by:

controlUpdate in class AbstractControl

Parameters:

tpf - time per frame (in seconds)

controlRender

protected void controlRender(RenderManager rm,
                             ViewPort vp)

Description copied from class: AbstractControl

To be implemented in subclass.

Specified by:

controlRender in class AbstractControl

Parameters:

rm - the RenderManager rendering the controlled Spatial (not null)

vp - the ViewPort being rendered (not null)

getGlobalSpeed

public float getGlobalSpeed()

setGlobalSpeed

public void setGlobalSpeed(float globalSpeed)

jmeClone

public java.lang.Object jmeClone()

Description copied from interface: JmeCloneable

Performs a regular shallow clone of the object. Some fields may also be cloned but generally only if they will never be shared with other objects. (For example, local Vector3fs and so on.)

This method is separate from the regular clone() method so that objects might still maintain their own regular java clone() semantics (perhaps even using Cloner for those methods). However, because Java's clone() has specific features in the sense of Object's clone() implementation, it's usually best to have some path for subclasses to bypass the public clone() method that might be cloning fields and instead get at the superclass protected clone() methods. For example, through super.jmeClone() or another protected clone method that some base class eventually calls super.clone() in.

Specified by:

jmeClone in interface JmeCloneable

Overrides:

jmeClone in class AbstractControl

Returns:

a new instance

cloneFields

public void cloneFields(Cloner cloner,
                        java.lang.Object original)

Description copied from interface: JmeCloneable

Implemented to perform deep cloning for this object, resolving local cloned references using the specified cloner. The object can call cloner.clone(fieldValue) to deep clone any of its fields.

Note: during normal clone operations the original object will not be needed as the clone has already had all of the fields shallow copied.

Specified by:

cloneFields in interface JmeCloneable

Overrides:

cloneFields in class AbstractControl

Parameters:

cloner - The cloner that is performing the cloning operation. The cloneFields method can call back into the cloner to make clones of its subordinate fields.

original - The original object from which this object was cloned. This is provided for the very rare case that this object needs to refer to its original for some reason. In general, all of the relevant values should have been transferred during the shallow clone and this object need merely clone what it wants.

read

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

Specified by:

read in interface Savable

Overrides:

read in class AbstractControl

Throws:

java.io.IOException

write

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

Specified by:

write in interface Savable

Overrides:

write in class AbstractControl

Throws:

java.io.IOException