CesiumViewerWidget

Members

animation :Animation

The animation widget.

autoStartRenderLoop :Boolean

If true, CesiumViewerWidget#startRenderLoop will be called automatically at the end of CesiumViewerWidget#startup.

Default Value:

• true

baseLayerPicker :BaseLayerPicker

The BaseLayerPicker widget.

enableDragDrop :Boolean

Allow the user to drag-and-drop CZML files into this widget. This is read-only after construction.

Default Value:

• false

enableWebGLDebugging :Boolean

Check for WebGL errors after every WebGL API call. Enabling this debugging feature comes at a substantial performance cost, halting and restarting the graphics pipeline hundreds of times per frame. But it can uncover problems that are otherwise very difficult to diagnose. This property is read-only after construction.

Default Value:

• false

endUserOptions :Object

An object containing settings supplied by the end user, typically from the query string of the URL of the page with the widget.

Examples

var ioQuery = require('dojo/io-query');
var endUserOptions = {};
if (window.location.search) {
    endUserOptions = ioQuery.queryToObject(window.location.search.substring(1));
}

var endUserOptions = {
    'source' : 'file.czml', // The relative URL of the CZML file to load at startup.
    'lookAt' : '123abc',    // The CZML ID of the object to track at startup.
    'theme'  : 'lighter',   // Use the dark-text-on-light-background theme.
    'loop'   : 0,           // Disable looping at end time, pause there instead.
    'stats'  : 1,           // Enable the FPS performance display.
    'debug'  : 1,           // Full WebGL error reporting at substantial performance cost.
};

fullscreen :FullscreenButton

The fullscreen widget, configured to put only the viewer widget into fullscreen mode by default.

resizeWidgetOnWindowResize :Boolean

Register this widget's resize handler to get called every time the browser window resize event fires. This is read-only after construction. Generally this should be true for full-screen widgets, and true for fluid layouts where the widget is likely to change size at the same time as the window. The exception is, if you use a Dojo layout where this widget exists inside a Dojo ContentPane or similar, you should set this to false, because Dojo will perform its own layout calculations and call this widget's resize handler automatically. This can also be false for a fixed-size widget. If unsure, test the widget with this set to false, and if window resizes cause the globe to stretch, change this to true.

Default Value:

• true

See:

• CesiumViewerWidget#resize

sceneModePicker :SceneModePicker

The SceneModePicker widget.

showSkyBox :Boolean

Determines if a sky box with stars is drawn around the globe. This is read-only after construction.

Default Value:

• true

See:

• SkyBox

showSun :Boolean

Determines if the sun is drawn. This is read-only after construction.

Default Value:

• true

See:

• Sun

skyBoxBaseUrl :String

The base URL for the sky box.

timeline :Timeline

The timeline widget.

Methods

addCzml

Add CZML data to the viewer.

Parameters:

Name	Type	Description
czml	CZML	The CZML (as objects) to be processed and added to the viewer.
source	string	The filename or URI that was the source of the CZML collection.
lookAt	string	Optional. The ID of the object to center the camera on.

See:

• CesiumViewerWidget#loadCzml

centerCameraOnObject

Have the camera track a particular object.

Parameters:

Name	Type	Description
selectedObject	Object	The object to track, or undefined to stop tracking.

centerCameraOnPick

Have the camera track a particular object based on the result of a pick.

Parameters:

Name	Type	Description
selectedObject	Object	The object to track, or undefined to stop tracking.

enableStatistics

Enable or disable the FPS (Frames Per Second) perfomance display.

Parameters:

Name	Type	Description
showStatistics	Boolean	true to enable it.

handleDrop

This function is called when files are dropped on the widget, if drag-and-drop is enabled.

Parameters:

Name	Type	Description
event	Object	The drag-and-drop event containing the dropped file(s).

highlightObject

Highlight an object in the scene, usually in response to a click or hover.

Parameters:

Name	Type	Description
selectedObject	Object	The object to highlight, or undefined to un-highlight.

initializeFrame

Initialize the current frame.

loadCzml

Asynchronously load and add CZML data to the viewer.

Parameters:

Name	Type	Description
source	string	The URI to load the CZML from.
lookAt	string	Optional. The ID of the object to center the camera on.

See:

• CesiumViewerWidget#addCzml

onLeftDrag

Override this function to be notified when the left mouse button is dragged.

Parameters:

Name	Type	Description
The	Object	object with the start and end position of the mouse.

onLeftMouseDown

Override this function to be notified when the left mouse button is pressed down.

Parameters:

Name	Type	Description
The	Object	object with the position of the mouse.

onLeftMouseUp

Override this function to be notified when the left mouse button is released.

Parameters:

Name	Type	Description
The	Object	object with the position of the mouse.

onObjectLeftDoubleClickSelected

Override this function to be notified when an object is left-double-clicked.

Parameters:

Name	Type	Description
selectedObject	Object	The object that was selected, or undefined to de-select.

onObjectMousedOver

Override this function to be notified when an object hovered by the mouse.

Parameters:

Name	Type	Description
selectedObject	Object	The object that was hovered, or undefined if the mouse moved off.

onObjectRightClickSelected

Override this function to be notified when an object is right-clicked.

Parameters:

Name	Type	Description
selectedObject	Object	The object that was selected, or undefined to de-select.

onObjectSelected

Override this function to be notified when an object is selected (left-click).

Parameters:

Name	Type	Description
selectedObject	Object	The object that was selected, or undefined to de-select.

onRightMouseDown

Override this function to be notified when the right mouse button is pressed down.

Parameters:

Name	Type	Description
The	Object	object with the position of the mouse.

onRightMouseUp

Override this function to be notified when the right mouse button is released.

Parameters:

Name	Type	Description
The	Object	object with the position of the mouse.

onSetupError

This function will get a callback in the event of setup failure, likely indicating a problem with WebGL support or the availability of a GL context.

Parameters:

Name	Type	Description
widget	Object	A reference to this widget
error	Object	The exception that was thrown during setup

onZoom

Override this function to be notified when the right mouse button is dragged or mouse wheel is zoomed.

Parameters:

Name	Type	Description
The	Object	object with the start and end position of the mouse.

removeAllCzml

Removes all CZML data from the viewer.

render

Render the widget's scene.

Parameters:

Name	Type	Description
currentTime	JulianDate	The date and time in the scene of the frame to be rendered

resize

This function must be called when the widget changes size. It updates the canvas size, camera aspect ratio, and viewport size.

See:

• CesiumViewerWidget#resizeWidgetOnWindowResize

setLogoOffset

Set the positional offset of the logo of the streaming imagery provider.

Parameters:

Name	Type	Description
logoOffsetX	Integer	The horizontal offset in screen space
logoOffsetY	Integer	The vertical offset in screen space

setTimeFromBuffer

Apply the animation settings from a CZML buffer.

showSkyAtmosphere

Enable or disable the "sky atmosphere" effect, which displays the limb of the Earth (seen from space) or blue sky (seen from inside the atmosphere).

Parameters:

Name	Type	Description
show	Boolean	true to enable the effect.

startRenderLoop

This is a simple render loop that can be started if there is only one CesiumViewerWidget on your page. If you wish to customize your render loop, avoid this function and instead use code similar to the following example.

Example

// This takes the place of startRenderLoop for a single widget.
 var widget = this;
 function updateAndRender() {
     widget.updateAndRender();
     requestAnimationFrame(updateAndRender);
 }
 requestAnimationFrame(updateAndRender);

See:

• requestAnimationFrame
• CesiumViewerWidget#autoStartRenderLoop

startup

Call this after placing the widget in the DOM, to initialize the WebGL context, wire up event callbacks, begin requesting CZML, imagery, etc.

See:

• CesiumViewerWidget#autoStartRenderLoop

update

Call this function prior to rendering each animation frame, to prepare all CZML objects and other settings for the next frame.

Parameters:

Name	Type	Description
currentTime	JulianDate	The date and time in the scene of the frame to be rendered

updateAndRender

Updates and renders the scene to reflect the current time.

viewHome

Reset the camera to the home view for the current scene mode.