活動的GLTF動畫。GLTF資源可以包含動畫。活動動畫是當前正在播放或計劃播放的動畫,因為它已添加到模型的
new ModelAnimation()
ModelAnimationCollection
。活動動畫是動畫的一個實例;例如,同一個GLTF動畫可以有多個活動動畫,每個動畫的開始時間都不同。通過調用ModelAnimationCollection#add
創建此項。
Members
(readonly) delay : Number
從
ModelAnimation#startTime
開始播放的延遲(秒)。
-
Default Value:
undefined
(readonly) loop : ModelAnimationLoop
確定動畫是否循環以及如何循環。
-
Default Value:
ModelAnimationLoop.NONE
(readonly) multiplier : Number
值大于
1.0
增加動畫相對于場景時鐘速度的播放速度;值小于1.0
降低速度。值1.0
以映射到場景時鐘速度的GLTF動畫中的速度播放動畫。例如,如果場景以2X實時播放,即使multiplier
是1.0
,兩秒鐘的GLTF動畫也將在一秒鐘內播放。
-
Default Value:
1.0
(readonly) name : String
標識此動畫的GLTF動畫名稱。
removeOnStop : Boolean
當
true
時,動畫停止播放后將被移除。這比不刪除它的效率稍高,但如果時間倒轉,動畫就不會再播放。
-
Default Value:
false
(readonly) reverse : Boolean
當
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);
});