用于跟踪模拟时间的简单时钟。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
optional
包含以下属性的对象:
|
Throws:
-
DeveloperError : startTime 必须在 stopTime 之前。
Example:
// 创建一个在2013年圣诞节当天循环并以实时运行的时钟。
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 属性的新值。
