com.jme3.animation

Class Skeleton

java.lang.Object

com.jme3.animation.Skeleton

All Implemented Interfaces:

Savable, JmeCloneable, java.lang.Cloneable

Deprecated.

use Armature

@Deprecated
public final class Skeleton
extends java.lang.Object
implements Savable, JmeCloneable

Skeleton is a convenience class for managing a bone hierarchy. Skeleton updates the world transforms to reflect the current local animated matrixes.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Skeleton() Deprecated. Serialization only.
	Skeleton(Bone[] boneList) Deprecated. Creates a skeleton from a bone list.
	Skeleton(Skeleton source) Deprecated. Special-purpose copy constructor.

Method Summary

Modifier and Type	Method and Description
void	cloneFields(Cloner cloner, java.lang.Object original) Deprecated. Implemented to perform deep cloning for this object, resolving local cloned references using the specified cloner.
Matrix4f[]	computeSkinningMatrices() Deprecated. Compute the skinning matrices for each bone of the skeleton that would be used to transform vertices of associated meshes
Bone	getBone(int index) Deprecated. return a bone for the given index
Bone	getBone(java.lang.String name) Deprecated. returns the bone with the given name
int	getBoneCount() Deprecated. returns the number of bones of this skeleton
int	getBoneIndex(Bone bone) Deprecated. returns the bone index of the given bone
int	getBoneIndex(java.lang.String name) Deprecated. returns the bone index of the bone that has the given name
Bone[]	getRoots() Deprecated. returns the array of all root bones of this skeleton
java.lang.Object	jmeClone() Deprecated. Performs a regular shallow clone of the object.
void	read(JmeImporter im) Deprecated.
void	reset() Deprecated. Reset the skeleton to bind pose.
void	resetAndUpdate() Deprecated. Reset the skeleton to bind pose and updates the bones
void	setBindingPose() Deprecated. Saves the current skeleton state as its binding pose.
java.lang.String	toString() Deprecated.
void	updateWorldVectors() Deprecated. Updates world transforms for all bones in this skeleton.
void	write(JmeExporter ex) Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

Skeleton

public Skeleton(Bone[] boneList)

Deprecated.

Creates a skeleton from a bone list. The root bones are found automatically.

Note that using this constructor will cause the bones in the list to have their bind pose recomputed based on their local transforms.

Parameters:

boneList - The list of bones to manage by this Skeleton

Skeleton

public Skeleton(Skeleton source)

Deprecated.

Special-purpose copy constructor.

Shallow copies bind pose data from the source skeleton, does not copy any other data.

Parameters:

source - The source Skeleton to copy from

Skeleton

protected Skeleton()

Deprecated.

Serialization only. Do not use.

Method Detail

jmeClone

public java.lang.Object jmeClone()

Deprecated.

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)

Deprecated.

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 only clone what it wants.

updateWorldVectors

public void updateWorldVectors()

Deprecated.

Updates world transforms for all bones in this skeleton. Typically called after setting local animation transforms.

setBindingPose

public void setBindingPose()

Deprecated.

Saves the current skeleton state as its binding pose.

reset

public final void reset()

Deprecated.

Reset the skeleton to bind pose.

resetAndUpdate

public final void resetAndUpdate()

Deprecated.

Reset the skeleton to bind pose and updates the bones

getRoots

public Bone[] getRoots()

Deprecated.

returns the array of all root bones of this skeleton

Returns:

the pre-existing array

getBone

public Bone getBone(int index)

Deprecated.

return a bone for the given index

Parameters:

index - the (zero-based) bone index (≥0)

Returns:

the pre-existing instance

getBone

public Bone getBone(java.lang.String name)

Deprecated.

returns the bone with the given name

Parameters:

name - the name to search for

Returns:

the pre-existing instance, or null if not found

getBoneIndex

public int getBoneIndex(Bone bone)

Deprecated.

returns the bone index of the given bone

Parameters:

bone - the Bone to search for (unaffected)

Returns:

the index (≥0) or -1 if not found

getBoneIndex

public int getBoneIndex(java.lang.String name)

Deprecated.

returns the bone index of the bone that has the given name

Parameters:

name - the name to search for

Returns:

the index (≥0) or -1 if not found

computeSkinningMatrices

public Matrix4f[] computeSkinningMatrices()

Deprecated.

Compute the skinning matrices for each bone of the skeleton that would be used to transform vertices of associated meshes

Returns:

the pre-existing matrices

getBoneCount

public int getBoneCount()

Deprecated.

returns the number of bones of this skeleton

Returns:

the count (≥0)

toString

public java.lang.String toString()

Deprecated.

Overrides:

toString in class java.lang.Object

read

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

Deprecated.

Specified by:

read in interface Savable

Throws:

java.io.IOException

write

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

Deprecated.

Specified by:

write in interface Savable

Throws:

java.io.IOException