com.jme3.anim

Class TransformTrack

java.lang.Object

com.jme3.anim.TransformTrack

All Implemented Interfaces:

AnimTrack<Transform>, Savable, JmeCloneable, java.lang.Cloneable

public class TransformTrack
extends java.lang.Object
implements AnimTrack<Transform>

Contains a list of transforms and times for each keyframe.

Constructor Summary

Constructors

Constructor and Description
TransformTrack() Serialization-only.
TransformTrack(HasLocalTransform target, float[] times, Vector3f[] translations, Quaternion[] rotations, Vector3f[] scales) Creates a transform track for the given bone index

Method Summary

Modifier and Type	Method and Description
void	cloneFields(Cloner cloner, java.lang.Object original) Implemented to perform deep cloning for this object, resolving local cloned references using the specified cloner.
void	getDataAtTime(double t, Transform transform) Determine the track value for the specified time.
double	getLength() Determine the duration of the track.
Quaternion[]	getRotations() return the array of rotations of this track
Vector3f[]	getScales() returns the array of scales for this track
HasLocalTransform	getTarget() Access the target affected by this track, which might be a Joint or a Spatial.
float[]	getTimes() returns the arrays of time for this track
Vector3f[]	getTranslations() returns the array of translations of this track
TransformTrack	jmeClone() Performs a regular shallow clone of the object.
void	read(JmeImporter im) De-serialize this track from the specified importer, for example when loading from a J3O file.
void	setFrameInterpolator(FrameInterpolator interpolator) Replace the frame interpolator.
void	setKeyframes(float[] times, Vector3f[] translations, Quaternion[] rotations, Vector3f[] scales) Set the translations, rotations and scales for this bone track
void	setKeyframesRotation(Quaternion[] rotations) Set the rotations for this joint track
void	setKeyframesScale(Vector3f[] scales) Set the scales for this joint track
void	setKeyframesTranslation(Vector3f[] translations) Set the translations for this joint track
void	setTarget(HasLocalTransform target) Replace the target of this track, which might be a Joint or a Spatial.
void	setTimes(float[] times) Sets the keyframes times for this Joint track
void	write(JmeExporter ex) Serialize this track to the specified exporter, for example when saving to a J3O file.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransformTrack

public TransformTrack()

Serialization-only. Do not use.

TransformTrack

public TransformTrack(HasLocalTransform target,
                      float[] times,
                      Vector3f[] translations,
                      Quaternion[] rotations,
                      Vector3f[] scales)

Creates a transform track for the given bone index

Parameters:

target - the target Joint or Spatial of the new track

times - a float array with the time of each frame

translations - the translation of the bone for each frame

rotations - the rotation of the bone for each frame

scales - the scale of the bone for each frame

Method Detail

getRotations

public Quaternion[] getRotations()

return the array of rotations of this track

Returns:

an array, or null if no rotations

getScales

public Vector3f[] getScales()

returns the array of scales for this track

Returns:

an array or null

getTimes

public float[] getTimes()

returns the arrays of time for this track

Returns:

the pre-existing array

getTranslations

public Vector3f[] getTranslations()

returns the array of translations of this track

Returns:

an array, or null if no translations

setTimes

public void setTimes(float[] times)

Sets the keyframes times for this Joint track

Parameters:

times - the keyframes times

setKeyframesTranslation

public void setKeyframesTranslation(Vector3f[] translations)

Set the translations for this joint track

Parameters:

translations - the translation of the bone for each frame

setKeyframesScale

public void setKeyframesScale(Vector3f[] scales)

Set the scales for this joint track

Parameters:

scales - the scales of the bone for each frame

setKeyframesRotation

public void setKeyframesRotation(Quaternion[] rotations)

Set the rotations for this joint track

Parameters:

rotations - the rotations of the bone for each frame

setKeyframes

public void setKeyframes(float[] times,
                         Vector3f[] translations,
                         Quaternion[] rotations,
                         Vector3f[] scales)

Set the translations, rotations and scales for this bone track

Parameters:

times - a float array with the time of each frame

translations - the translation of the bone for each frame

rotations - the rotation of the bone for each frame

scales - the scale of the bone for each frame

getLength

public double getLength()

Description copied from interface: AnimTrack

Determine the duration of the track.

Specified by:

getLength in interface AnimTrack<Transform>

Returns:

the duration (in seconds, ≥0)

getDataAtTime

public void getDataAtTime(double t,
                          Transform transform)

Description copied from interface: AnimTrack

Determine the track value for the specified time.

Specified by:

getDataAtTime in interface AnimTrack<Transform>

Parameters:

t - the track time (in seconds)

transform - storage for the value (not null, modified)

setFrameInterpolator

public void setFrameInterpolator(FrameInterpolator interpolator)

Replace the frame interpolator.

Parameters:

interpolator - the interpolator to use (alias created)

getTarget

public HasLocalTransform getTarget()

Access the target affected by this track, which might be a Joint or a Spatial.

Returns:

the pre-existing instance

setTarget

public void setTarget(HasLocalTransform target)

Replace the target of this track, which might be a Joint or a Spatial.

Parameters:

target - the target to use (alias created)

write

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

Serialize this track to the specified exporter, for example when saving to a J3O file.

Specified by:

write in interface Savable

Parameters:

ex - the exporter to write to (not null)

Throws:

java.io.IOException - from the exporter

read

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

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

Specified by:

read in interface Savable

Parameters:

im - the importer to read from (not null)

Throws:

java.io.IOException - from the importer

jmeClone

public TransformTrack 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

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

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.