活动的glTF动画。 glTF资产可以包含动画。活跃的动画是当前正在播放或计划播放的动画,因为已添加到模型的
ModelAnimationCollection
中。活动动画是动画实例;例如,可以有多个活动动画对于相同的glTF动画,每个动画具有不同的开始时间。
通过调用
ModelAnimationCollection#add
来创建此文件。
Members
从
ModelAnimation#startTime
开始播放的延迟(以秒为单位)。
-
Default Value:
undefined
readonly loop : ModelAnimationLoop
确定是否以及如何循环播放动画。
-
Default Value:
ModelAnimationLoop.NONE
大于
1.0
的值可提高动画播放的速度现场时钟速度;小于
1.0
的值会降低速度。值
1.0
以映射到场景的glTF动画中的速度播放动画时钟速度。例如,如果场景以2倍实时播放,则为2秒的glTF动画即使
multiplier
是
1.0
,也将在一秒钟内播放。
-
Default Value:
1.0
标识此动画的glTF动画名称。
如果为
true
,则在动画停止播放后将其删除。与不删除它相比,这会稍微提高效率,但是例如,时间倒转,动画将不再播放。
-
Default Value:
false
当
true
时,动画将反向播放。
-
Default Value:
false
start : Event
启动此动画时触发该事件。这可以用于例如,在动画开始时播放声音或启动粒子系统。
渲染场景后,在帧的末尾触发此事件。
-
Default Value:
new Event()
Example:
animation.start.addEventListener(function(model, animation) {
console.log('Animation started: ' + animation.name);
});
readonly startTime : JulianDate
开始播放此动画的场景时间。如果这是
undefined
,动画从下一帧开始。
-
Default Value:
undefined
stop : Event
停止动画播放时触发该事件。这可以用于例如,在动画停止时播放声音或启动粒子系统。
渲染场景后,在帧的末尾触发此事件。
-
Default Value:
new Event()
Example:
animation.stop.addEventListener(function(model, animation) {
console.log('Animation stopped: ' + animation.name);
});
readonly stopTime : JulianDate
场景时间停止播放此动画。如果这是
undefined
,动画将在其整个播放过程中播放,并且可能会重复播放,具体取决于
ModelAnimation#loop
。
-
Default Value:
undefined
update : Event
更新此动画时,在每个帧上触发该事件。的动画的当前时间(相对于glTF动画时间跨度)为传递给事件,例如,允许在相对于播放动画的特定时间。
渲染场景后,在帧的末尾触发此事件。
-
Default Value:
new Event()
Example:
animation.update.addEventListener(function(model, animation, time) {
console.log('Animation updated: ' + animation.name + '. glTF animation time: ' + time);
});