一个用于跟踪模拟时间的简单时钟。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
optional
包含以下属性的对象:
|
Throws:
-
DeveloperError : startTime 必须早于 stopTime。
Example:
// Create a clock that loops on Christmas day 2013 and runs in real-time.
const clock = new Cesium.Clock({
startTime : Cesium.JulianDate.fromIso8601("2013-12-25"),
currentTime : Cesium.JulianDate.fromIso8601("2013-12-25"),
stopTime : Cesium.JulianDate.fromIso8601("2013-12-26"),
clockRange : Cesium.ClockRange.LOOP_STOP,
clockStep : Cesium.ClockStep.SYSTEM_CLOCK_MULTIPLIER
});
See:
Members
指示
Clock#tick 是否能够推进时间。例如,如果正在缓冲数据,则可能为 false。只有在 Clock#canAnimate 和 Clock#shouldAnimate 都为 true 时,时钟才会推进时间。
-
Default Value:
true
clockRange : ClockRange
确定当到达
Clock#startTime 或 Clock#stopTime 时,时钟应当如何表现。
-
Default Value:
ClockRange.UNBOUNDED
clockStep : ClockStep
确定对
Clock#tick 的调用是依赖于帧还是依赖于系统时钟。
将此属性更改为 ClockStep.SYSTEM_CLOCK 会将
Clock#multiplier 设为 1.0,将 Clock#shouldAnimate 设为 true,并将
Clock#currentTime 设为当前系统时钟时间。
-
Default Value:
ClockStep.SYSTEM_CLOCK_MULTIPLIER
currentTime : JulianDate
获取或设置调用
Clock#tick 时推进了多少时间。负值允许向后推进。
如果 Clock#clockStep 设置为 ClockStep.TICK_DEPENDENT,则这是要推进的秒数。
如果 Clock#clockStep 设置为 ClockStep.SYSTEM_CLOCK_MULTIPLIER,则此值会乘以上一次调用 Clock#tick 以来
经过的系统时间。
更改此属性会将
Clock#clockStep 从 ClockStep.SYSTEM_CLOCK 更改为
ClockStep.SYSTEM_CLOCK_MULTIPLIER。
-
Default Value:
1.0
onStop : Event
一个在到达
Clock#stopTime 时触发的 Event。
onTick : Event
一个在每次调用
Clock#tick 时触发的 Event。
指示
Clock#tick 是否应当尝试推进时间。
只有在 Clock#canAnimate 和 Clock#shouldAnimate 都为 true 时,时钟才会推进时间。
更改此属性会将
Clock#clockStep 从 ClockStep.SYSTEM_CLOCK 更改为
ClockStep.SYSTEM_CLOCK_MULTIPLIER。
-
Default Value:
false
startTime : JulianDate
时钟的起始时间。
stopTime : JulianDate
时钟的停止时间。
Methods
根据当前的配置选项,从当前时间推进时钟。
无论是否正在播放动画,都应每一帧调用 tick。
要控制动画,请使用
Clock#shouldAnimate 属性。
Returns:
该
Clock#currentTime 属性的新值。
