Class Skeleton

Use an array of bones to create a Skeleton that can be used by a 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

boneInverses boneMatrices boneTexture bones frame uuid

Methods

calculateInverses clone computeBoneTexture dispose fromJSON getBoneByName init pose toJSON update

Constructors

constructor

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

  • Creates a new Skeleton.

    Parameters

    • Optional bones: Bone[]

      The array of bones. Default [].

    • Optional boneInverses: Matrix4[]

      An array of Matrix4s. Default [].

    Returns Skeleton

Properties

boneInverses

boneInverses: Matrix4[]

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

boneMatrices

boneMatrices: Float32Array

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

boneTexture

boneTexture: null | DataTexture

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

bones

bones: Bone[]

The array of 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.

frame

frame: number

uuid

uuid: string

UUID of this object instance.

Remarks

This gets automatically assigned and shouldn't be edited.

Methods

calculateInverses

  • calculateInverses(): void

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

    Returns void

clone

  • clone(): Skeleton

  • Returns a clone of this Skeleton object.

    Returns Skeleton

computeBoneTexture

  • computeBoneTexture(): this

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

    Returns this

    Remarks

    The texture is assigned to boneTexture.

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.

fromJSON

  • fromJSON(json, bones): void

  • Parameters

    • json: unknown
    • bones: Record<string, Bone>

    Returns void

getBoneByName

  • getBoneByName(name): undefined | Bone

  • Searches through the skeleton's bone array and returns the first with a matching name.

    Parameters

    • name: string

      String to match to the Bone's THREE.Bone.name | .name property.

    Returns undefined | Bone

init

  • init(): void

  • Returns void

pose

  • pose(): void

  • Returns the skeleton to the base pose.

    Returns void

toJSON

  • toJSON(): unknown

  • Returns unknown

update

Settings

Member Visibility

On This Page

constructorboneInversesboneMatricesboneTexturebonesframeuuidcalculateInversesclonecomputeBoneTexturedisposefromJSONgetBoneByNameinitposetoJSONupdate