---

title: MorphBlendMesh category: Addons layout: docs

MorphBlendMesh

A special type of an animated mesh with a more advanced interface for animation playback. Unlike MorphAnimMesh. It allows to playback more than one morph animation at the same time but without fading options.

Import

MorphBlendMesh is an addon, and must be imported explicitly, see Installation#Addons.

import { MorphBlendMesh } from 'three/addons/misc/MorphBlendMesh.js';

Constructor

new MorphBlendMesh( geometry : BufferGeometry, material : Material | Array.<Material> )

Constructs a new morph blend mesh.

geometry | The mesh geometry.
---|---
material | The mesh material.

Properties

.animationsList : Array.<Object>

A list of animations.

.animationsMap : Object.<string, Object>

A dictionary of animations.

Methods

.autoCreateAnimations( fps : number )

Automatically creates animations based on the values in Mesh#morphTargetDictionary.

fps | The FPS of all animations.
---|---

.createAnimation( name : string, start : number, end : number, fps : number )

Creates a new animation.

name | The animation name.
---|---
start | The start time.
end | The end time.
fps | The FPS.

.getAnimationDuration( name : string ) : number

Returns the duration for the defined animation.

name | The animation name.
---|---

Returns: The duration.

.getAnimationTime( name : string ) : number

Returns the time for the defined animation.

name | The animation name.
---|---

Returns: The time.

.playAnimation( name : string )

Plays the defined animation.

name | The animation name.
---|---

.setAnimationDirectionBackward( name : string )

Sets the animation playback direction to "backward" for the defined animation.

name | The animation name.
---|---

.setAnimationDirectionForward( name : string )

Sets the animation playback direction to "forward" for the defined animation.

name | The animation name.
---|---

.setAnimationDuration( name : string, duration : number )

Sets the duration to the given value for the defined animation.

name | The animation name.
---|---
duration | The duration to set.

.setAnimationFPS( name : string, fps : number )

Sets the FPS to the given value for the defined animation.

name | The animation name.
---|---
fps | The FPS to set.

.setAnimationTime( name : string, time : number )

Sets the time to the given value for the defined animation.

name | The animation name.
---|---
time | The time to set.

.setAnimationWeight( name : string, weight : number )

Sets the weight to the given value for the defined animation.

name | The animation name.
---|---
weight | The weight to set.

.stopAnimation( name : string )

Stops the defined animation.

name | The animation name.
---|---

.update( delta : number )

Updates the animations of the mesh.

delta | The delta time in seconds.
---|---

Source

examples/jsm/misc/MorphBlendMesh.js