Class Skeleton

Use an array of bones to create a Skeleton that can be used by a THREE.SkinnedMesh | SkinnedMesh.

Example

// Create a simple "arm"
const bones = [];
const shoulder = new THREE.Bone();
const elbow = new THREE.Bone();
const hand = new THREE.Bone();
shoulder.add(elbow);
elbow.add(hand);
bones.push(shoulder);
bones.push(elbow);
bones.push(hand);
shoulder.position.y = -5;
elbow.position.y = 0;
hand.position.y = 5;
const armSkeleton = new THREE.Skeleton(bones);
See the[page: SkinnedMesh] page
for an example of usage with standard[page: BufferGeometry].

See

Constructors

constructor

Properties

uuid bones boneInverses boneMatrices boneTexture frame

Methods

init calculateInverses computeBoneTexture pose update clone getBoneByName dispose toJSON fromJSON

Constructors

constructor

  • new Skeleton(bones?, boneInverses?): Skeleton

  • Creates a new Skeleton.

    Parameters

    • Optionalbones: Bone<Object3DEventMap>[]

      The array of THREE.Bone | bones. Default [].

    • OptionalboneInverses: Matrix4[]

      An array of THREE.Matrix4 | Matrix4s. Default [].

    Returns Skeleton

Properties

uuid

uuid: string

UUID of this object instance.

Remarks

This gets automatically assigned and shouldn't be edited.

bones

bones: Bone<Object3DEventMap>[]

The array of THREE.Bone | Bones.

Remarks

Note this is a copy of the original array, not a reference, so you can modify the original array without effecting this one.

boneInverses

boneInverses: Matrix4[]

An array of Matrix4s that represent the inverse of the THREE.Matrix4 | matrixWorld of the individual bones.

boneMatrices

boneMatrices: Float32Array

The array buffer holding the bone data when using a vertex texture.

boneTexture

boneTexture: DataTexture

The THREE.DataTexture | DataTexture holding the bone data when using a vertex texture.

frame

frame: number

Methods

init

  • init(): void

  • Returns void

calculateInverses

  • calculateInverses(): void

  • Generates the boneInverses array if not provided in the constructor.

    Returns void

computeBoneTexture

  • computeBoneTexture(): this

  • Computes an instance of THREE.DataTexture | DataTexture in order to pass the bone data more efficiently to the shader

    Returns this

    Remarks

    The texture is assigned to boneTexture.

pose

  • pose(): void

  • Returns the skeleton to the base pose.

    Returns void

update

  • update(): void

  • Updates the boneMatrices and boneTexture after changing the bones

    Returns void

    Remarks

    This is called automatically by the THREE.WebGLRenderer | WebGLRenderer if the Skeleton is used with a THREE.SkinnedMesh | SkinnedMesh.

clone

getBoneByName

dispose

  • dispose(): void

  • Frees the GPU-related resources allocated by this instance

    Returns void

    Remarks

    Call this method whenever this instance is no longer used in your app.

toJSON

  • toJSON(): unknown

  • Returns unknown

fromJSON

  • fromJSON(json, bones): void

  • Parameters

    Returns void

Settings

Member Visibility

On This Page

Constructors
Properties
Methods