Globe

Members

baseColor : Color

Scene/Globe.js 260

Gets or sets the color of the globe when no imagery is available.

clippingPlanes : ClippingPlaneCollection

Scene/Globe.js 274

A property specifying a ClippingPlaneCollection used to selectively disable rendering on the outside of each plane. Clipping planes are not currently supported in Internet Explorer.

depthTestAgainstTerrain : Boolean

Scene/Globe.js 179

True if primitives such as billboards, polylines, labels, etc. should be depth-tested against the terrain surface, or false if such primitives should always be drawn on top of terrain unless they're on the opposite side of the globe. The disadvantage of depth testing primitives against terrain is that slight numerical noise or terrain level-of-detail switched can sometimes make a primitive that should be on the surface disappear underneath it.

Default Value: false

ellipsoid : Ellipsoid

Scene/Globe.js 201

Gets an ellipsoid describing the shape of this globe.

enableLighting : Boolean

Scene/Globe.js 138

Enable lighting the globe with the sun as a light source.

Default Value: false

imageryLayers : ImageryLayerCollection

Scene/Globe.js 211

Gets the collection of image layers that will be rendered on this globe.

readonlyimageryLayersUpdatedEvent : Event

Scene/Globe.js 223

Gets an event that's raised when an imagery layer is added, shown, hidden, moved, or removed.

lightingFadeInDistance : Number

Scene/Globe.js 156

The distance where lighting resumes. This only takes effect when enableLighting is true.

Default Value: 9000000.0

lightingFadeOutDistance : Number

Scene/Globe.js 147

The distance where everything becomes lit. This only takes effect when enableLighting is true.

Default Value: 6500000.0

material : Material

Scene/Globe.js 351

Gets or sets the material appearance of the Globe. This can be one of several built-in Material objects or a custom material, scripted with Fabric.

maximumScreenSpaceError : Number

Scene/Globe.js 119

The maximum screen-space error used to drive level-of-detail refinement. Higher values will provide better performance but lower visual quality.

Default Value: 2

oceanNormalMapUrl : String

Scene/Globe.js 289

The normal map to use for rendering waves in the ocean. Setting this property will only have an effect if the configured terrain provider includes a water mask.

Default Value: buildModuleUrl('Assets/Textures/waterNormalsSmall.jpg')

shadows : ShadowMode

Scene/Globe.js 189

Determines whether the globe casts or receives shadows from each light source. Setting the globe to cast shadows may impact performance since the terrain is rendered again from the light's perspective. Currently only terrain that is in view casts shadows. By default the globe does not cast shadows.

Default Value: ShadowMode.RECEIVE_ONLY

show : Boolean

Scene/Globe.js 105

Determines if the globe will be shown.

Default Value: true

showWaterEffect : Boolean

Scene/Globe.js 166

True if an animated wave effect should be shown in areas of the globe covered by water; otherwise, false. This property is ignored if the terrainProvider does not provide a water mask.

Default Value: true

terrainProvider : TerrainProvider

Scene/Globe.js 306

The terrain provider providing surface geometry for this globe.

readonlyterrainProviderChanged : Event

Scene/Globe.js 327

Gets an event that's raised when the terrain provider is changed

tileCacheSize : Number

Scene/Globe.js 130

The size of the terrain tile cache, expressed as a number of tiles. Any additional tiles beyond this number will be freed, as long as they aren't needed for rendering this frame. A larger number will consume more memory but will show detail faster when, for example, zooming out and then back in.

Default Value: 100

readonlytileLoadedEvent : Event

Scene/Globe.js 235

Gets an event that's raised when a surface tile is loaded and ready to be rendered.

tileLoadProgressEvent : Event

Scene/Globe.js 339

Gets an event that's raised when the length of the tile load queue has changed since the last render frame. When the load queue is empty, all terrain and imagery for the current view have been loaded. The event passes the new length of the tile load queue.

readonlytilesLoaded : Boolean

Scene/Globe.js 247

Returns true when the tile load queue is empty, false otherwise. When the load queue is empty, all terrain and imagery for the current view have been loaded.

Methods

destroy() → undefined

Scene/Globe.js 707

Destroys the WebGL resources held by this object. Destroying an object allows for deterministic release of WebGL resources, instead of relying on the garbage collector to destroy this object.

Once an object is destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception. Therefore, assign the return value (undefined) to the object as done in the example.

Returns:

Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

Example:

globe = globe && globe.destroy();

See:

• Globe#isDestroyed

getHeight(cartographic) → Number|undefined

Scene/Globe.js 492

Get the height of the surface at a given cartographic.

Name	Type	Description
cartographic	Cartographic	The cartographic for which to find the height.

Returns:

The height of the cartographic or undefined if it could not be found.

isDestroyed() → Boolean

Scene/Globe.js 685

Returns true if this object was destroyed; otherwise, false.

If this object was destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception.

Returns:

True if this object was destroyed; otherwise, false.

See:

• Globe#destroy

pick(ray, scene, result) → Cartesian3|undefined

Scene/Globe.js 419

Find an intersection between a ray and the globe surface that was rendered. The ray must be given in world coordinates.

Name	Type	Description
ray	Ray	The ray to test for intersection.
scene	Scene	The scene.
result	Cartesian3	optional The object onto which to store the result.

Returns:

The intersection or undefined if none was found.

Example:

// find intersection of ray through a pixel and the globe
var ray = viewer.camera.getPickRay(windowCoordinates);
var intersection = globe.pick(ray, scene);