AnimationMixer

动画混合器是用于场景中特定对象的动画的播放器。当场景中的多个对象独立动画时,每个对象都可以使用同一个动画混合器。

在使用手册的“下一步”章节中,“动画系统”一文对Verge3D动画系统中的不同元素作出了概述

构造函数

AnimationMixer(rootObject : Object3D)

rootObject — 混合器播放的动画所属的对象

属性

.time : Number

全局的混合器时间(单位秒; 混合器创建的时刻记作0时刻)

.timeScale : Number

全局时间(mixer time)的比例因子

说明: 将混合器的时间比例设为0, 稍后再设置为1,可以暂停/取消暂停由该混合器控制的所有动作。

.setTime(timeInSeconds : Number) → AnimationMixer

设置全局混合器到一个给定的时间,并相应地更新动画。

当你需要在一个动画里跳转到一个精确的时间,该函数将是十分有用的。输入的参数将会被混合器的timeScale进行缩放。

方法

.clipAction(clip : AnimationClip, optionalRoot : Object3D) → AnimationAction

返回所传入的剪辑参数的AnimationAction, 根对象参数可选,默认值为混合器的默认根对象。第一个参数可以是动画剪辑(AnimationClip)对象或者动画剪辑的名称。

如果不存在符合传入的剪辑和根对象这两个参数的动作, 该方法将会创建一个。传入相同的参数多次调用将会返回同一个剪辑实例。

.existingAction(clip : AnimationClip, optionalRoot : Object3D) → AnimationAction

返回传入剪辑的已有AnimationAction, 根对象参数可选,默认值为混合器的默认根对象。

第一个参数可以是动画剪辑(AnimationClip)对象或者动画剪辑的名称。

.getRoot() → Object3D

返回混合器的根对象

.stopAllAction() → AnimationMixer

停用混合器上所有预定的动作

.update(deltaTimeInSeconds : Number) → AnimationMixer

推进混合器时间并更新动画

通常在渲染循环中完成, 传入按照混合器的时间比例(timeScale)缩放过的clock.getDelta

.uncacheClip(clip : AnimationClip) → null

释放剪辑的所有内存资源

.uncacheRoot(root : Object3D) → null

释放根对象的所有内存资源

.uncacheAction(clip : AnimationClip, optionalRoot : Object3D) → null

释放动作的所有内存资源

源码

src/animation/AnimationMixer.js