Animation

Animation

new


Animation widget


The Animation widget provides buttons for play, pause, and reverse, along with the current time and date, surrounded by a "shuttle ring" for controlling the speed of animation.

The "shuttle ring" concept is borrowed from video editing, where typically a "jog wheel" can be rotated to move past individual animation frames very slowly, and a surrounding shuttle ring can be twisted to control direction and speed of fast playback. Cesium typically treats time as continuous (not broken into pre-defined animation frames), so this widget offers no jog wheel. Instead, the shuttle ring is capable of both fast and very slow playback. Click and drag the shuttle ring pointer itself (shown above in green), or click in the rest of the ring area to nudge the pointer to the next preset speed in that direction.

The Animation widget also provides a "realtime" button (in the upper-left) that keeps animation time in sync with the end user's system clock, typically displaying "today" or "right now." This mode is not available in ClockRange.CLAMPED or ClockRange.LOOP_STOP mode if the current time is outside of Clock's startTime and endTime.

Parameters:
Name Type Description
container Element | String The DOM element or ID that will contain the widget.
viewModel AnimationViewModel The ViewModel used by this widget.
Throws:
Example
// In HTML head, include a link to Animation.css stylesheet,
// and in the body, include: <div id="animationContainer"></div>

var clock = new Clock();
var clockViewModel = new ClockViewModel(clock);
var viewModel = new AnimationViewModel(clockViewModel);
var widget = new Animation('animationContainer', viewModel);

function tick() {
    clock.tick();
    Cesium.requestAnimationFrame(tick);
}
Cesium.requestAnimationFrame(tick);
See:
Source:

Members

<static> :Element

Gets the parent container.

<static> :AnimationViewModel

The viewModel

Methods

Updates the widget to reflect any modified CSS fules for themeing.

Example
//Switch to the cesium-lighter theme.
document.body.className = 'cesium-lighter';
animation.applyThemeChanges();

Destroys the animation widget. Should be called if permanently removing the widget from layout.

Returns:
Boolean true if the object has been destroyed, false otherwise.