活动的glTF动画。glTF资源可以包含动画。活动动画是当前正在播放或计划播放的动画,因为它被添加到模型的
ModelAnimationCollection
中。
活动动画是动画的实例;例如,同一个glTF动画可以有多个活动动画,每个动画都有不同的开始时间。
Create this by calling ModelAnimationCollection#add
.
Members
-
从
ModelAnimation#startTime
开始播放的延迟时间,以秒为单位。-
Default Value:
undefined
-
readonlyloop : ModelAnimationLoop
-
确定动画是否循环以及如何循环。
-
Default Value:
ModelAnimationLoop.NONE
-
用于标识此动画的 glTF 动画名称。
-
为 true 时,动画会在停止播放后被移除。这比不移除动画的效率要高一些,但如果时间发生逆转等情况,动画就不会再次播放。
-
Default Value:
false
-
当为true时,动画将反向播放。
-
Default Value:
false
-
大于
1.0
的值增加动画相对于场景时钟速度的播放速度;小于1.0
的值会降低速度。1.0
以映射到场景时钟速度的glTF动画中的速度播放动画。 例如,如果场景以2倍实时播放,即使加速
为1.0
,2秒的glTF动画也会在1秒内播放。-
Default Value:
1.0
-
start : Event
-
动画启动时触发的事件。例如,当动画开始时,这可以用于播放声音或启动粒子系统。
此事件在场景渲染后的帧结束时触发。
-
Default Value:
new Event()
Example:
animation.start.addEventListener(function(model, animation) { console.log('Animation started: ' + animation.name); });
-
readonlystartTime : JulianDate
-
开始播放该动画的场景时间。如果未定义,动画将从下一帧开始播放。
-
Default Value:
undefined
-
stop : Event
-
此动画停止时触发的事件。例如,当动画停止时,这可以用于播放声音或启动粒子系统。
此事件在场景渲染后的帧结束时触发。
-
Default Value:
new Event()
Example:
animation.stop.addEventListener(function(model, animation) { console.log('Animation stopped: ' + animation.name); });
-
readonlystopTime : JulianDate
-
该场景停止播放此动画了。当未定义时,动画将在整个持续时间内播放,并可能根据
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); });