qiusj
/
learning_cesium
0
0
Fork 0
Code Issues Issues Pull Requests Packages Projects Releases Wiki Wiki Activity
learning_cesium/Build168/Documentation/Globe.html

2963 lines
80 KiB
HTML
Raw Normal View History

init project
2024-03-19 18:06:25 +08:00
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Globe - Cesium Documentation</title>
<!--[if lt IE 9]>
<script src="javascript/html5.js"></script>
<![endif]-->
<link href="styles/jsdoc-default.css" rel="stylesheet">
<link href="styles/prism.css" rel="stylesheet">
</head>
<body>
<div id="main">
<h1 class="page-title">
<a href="index.html"><img src="Images/CesiumLogo.png" class="cesiumLogo"></a>
Globe
<div class="titleCenterer"></div>
</h1>
<section>
<header>
</header>
<article>
<div class="container-overview">
<div class="nameContainer">
<h4 class="name" id="Globe">
<a href="#Globe" class="doc-link"></a>
new Cesium.Globe<span class="signature">(<span class="optional">ellipsoid</span>)</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L39">Scene/Globe.js 39</a>
</div>
</h4>
</div>
<div class="description">
The globe rendered in the scene, including its terrain (<a href="Globe.html#terrainProvider"><code>Globe#terrainProvider</code></a>)
and imagery layers (<a href="Globe.html#imageryLayers"><code>Globe#imageryLayers</code></a>). Access the globe using <a href="Scene.html#globe"><code>Scene#globe</code></a>.
</div>
<table class="params">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Default</th>
<th class="last">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td class="name"><code>ellipsoid</code></td>
<td class="type">
<span class="param-type"><a href="Ellipsoid.html">Ellipsoid</a></span>
</td>
<td class="default">
<code class="language-javascript">Ellipsoid.WGS84</code>
</td>
<td class="description last">
<span class="optional">optional</span>
Determines the size and shape of the
globe.</td>
</tr>
</tbody>
</table>
<dl class="details">
</dl>
</div>
<h3 class="subsection-title">Members</h3>
<div class="nameContainer">
<h4 class="name" id="atmosphereBrightnessShift">
<a href="#atmosphereBrightnessShift" class="doc-link"></a>
atmosphereBrightnessShift<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L270">Scene/Globe.js 270</a>
</div>
</h4>
</div>
<div class="description">
The brightness shift to apply to the atmosphere. Defaults to 0.0 (no shift).
A brightness shift of -1.0 is complete darkness, which will let space show through.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">0.0</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="atmosphereHueShift">
<a href="#atmosphereHueShift" class="doc-link"></a>
atmosphereHueShift<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L254">Scene/Globe.js 254</a>
</div>
</h4>
</div>
<div class="description">
The hue shift to apply to the atmosphere. Defaults to 0.0 (no shift).
A hue shift of 1.0 indicates a complete rotation of the hues available.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">0.0</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="atmosphereSaturationShift">
<a href="#atmosphereSaturationShift" class="doc-link"></a>
atmosphereSaturationShift<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L262">Scene/Globe.js 262</a>
</div>
</h4>
</div>
<div class="description">
The saturation shift to apply to the atmosphere. Defaults to 0.0 (no shift).
A saturation shift of -1.0 is monochrome.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">0.0</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="backFaceCulling">
<a href="#backFaceCulling" class="doc-link"></a>
backFaceCulling<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L287">Scene/Globe.js 287</a>
</div>
</h4>
</div>
<div class="description">
Whether to cull back-facing terrain. Set this to false when viewing terrain from below the surface.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">true</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="baseColor">
<a href="#baseColor" class="doc-link"></a>
baseColor<span class="type-signature"> : <a href="Color.html">Color</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L346">Scene/Globe.js 346</a>
</div>
</h4>
</div>
<div class="description">
Gets or sets the color of the globe when no imagery is available.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="clippingPlanes">
<a href="#clippingPlanes" class="doc-link"></a>
clippingPlanes<span class="type-signature"> : <a href="ClippingPlaneCollection.html">ClippingPlaneCollection</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L360">Scene/Globe.js 360</a>
</div>
</h4>
</div>
<div class="description">
A property specifying a <a href="ClippingPlaneCollection.html"><code>ClippingPlaneCollection</code></a> used to selectively disable rendering on the outside of each plane.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="depthTestAgainstTerrain">
<a href="#depthTestAgainstTerrain" class="doc-link"></a>
depthTestAgainstTerrain<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L236">Scene/Globe.js 236</a>
</div>
</h4>
</div>
<div class="description">
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.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">false</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="dynamicAtmosphereLighting">
<a href="#dynamicAtmosphereLighting" class="doc-link"></a>
dynamicAtmosphereLighting<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L155">Scene/Globe.js 155</a>
</div>
</h4>
</div>
<div class="description">
Enable dynamic lighting effects on atmosphere and fog. This only takes effect
when <code>enableLighting</code> is <code>true</code>.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">true</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="dynamicAtmosphereLightingFromSun">
<a href="#dynamicAtmosphereLightingFromSun" class="doc-link"></a>
dynamicAtmosphereLightingFromSun<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L165">Scene/Globe.js 165</a>
</div>
</h4>
</div>
<div class="description">
Whether dynamic atmosphere lighting uses the sun direction instead of the scene's
light direction. This only takes effect when <code>enableLighting</code> and
<code>dynamicAtmosphereLighting</code> are <code>true</code>.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">false</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="ellipsoid">
<a href="#ellipsoid" class="doc-link"></a>
ellipsoid<span class="type-signature"> : <a href="Ellipsoid.html">Ellipsoid</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L299">Scene/Globe.js 299</a>
</div>
</h4>
</div>
<div class="description">
Gets an ellipsoid describing the shape of this globe.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="enableLighting">
<a href="#enableLighting" class="doc-link"></a>
enableLighting<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L146">Scene/Globe.js 146</a>
</div>
</h4>
</div>
<div class="description">
Enable lighting the globe with the scene's light source.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">false</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="fillHighlightColor">
<a href="#fillHighlightColor" class="doc-link"></a>
fillHighlightColor<span class="type-signature"> : <a href="Color.html">Color</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L138">Scene/Globe.js 138</a>
</div>
</h4>
</div>
<div class="description">
The color to use to highlight terrain fill tiles. If undefined, fill tiles are not
highlighted at all. The alpha value is used to alpha blend with the tile's
actual color. Because terrain fill tiles do not represent the actual terrain surface,
it may be useful in some applications to indicate visually that they are not to be trusted.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">undefined</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="imageryLayers">
<a href="#imageryLayers" class="doc-link"></a>
imageryLayers<span class="type-signature"> : <a href="ImageryLayerCollection.html">ImageryLayerCollection</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L309">Scene/Globe.js 309</a>
</div>
</h4>
</div>
<div class="description">
Gets the collection of image layers that will be rendered on this globe.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="imageryLayersUpdatedEvent">
<a href="#imageryLayersUpdatedEvent" class="doc-link"></a>
<span class="type-signature attribute-readonly">readonly</span>imageryLayersUpdatedEvent<span class="type-signature"> : <a href="Event.html">Event</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L321">Scene/Globe.js 321</a>
</div>
</h4>
</div>
<div class="description">
Gets an event that's raised when an imagery layer is added, shown, hidden, moved, or removed.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="lightingFadeInDistance">
<a href="#lightingFadeInDistance" class="doc-link"></a>
lightingFadeInDistance<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L193">Scene/Globe.js 193</a>
</div>
</h4>
</div>
<div class="description">
The distance where lighting resumes. This only takes effect
when <code>enableLighting</code> or <code>showGroundAtmosphere</code> is <code>true</code>.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">20000000.0</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="lightingFadeOutDistance">
<a href="#lightingFadeOutDistance" class="doc-link"></a>
lightingFadeOutDistance<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L184">Scene/Globe.js 184</a>
</div>
</h4>
</div>
<div class="description">
The distance where everything becomes lit. This only takes effect
when <code>enableLighting</code> or <code>showGroundAtmosphere</code> is <code>true</code>.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">10000000.0</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="loadingDescendantLimit">
<a href="#loadingDescendantLimit" class="doc-link"></a>
loadingDescendantLimit<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L109">Scene/Globe.js 109</a>
</div>
</h4>
</div>
<div class="description">
Gets or sets the number of loading descendant tiles that is considered "too many".
If a tile has too many loading descendants, that tile will be loaded and rendered before any of
its descendants are loaded and rendered. This means more feedback for the user that something
is happening at the cost of a longer overall load time. Setting this to 0 will cause each
tile level to be loaded successively, significantly increasing load time. Setting it to a large
number (e.g. 1000) will minimize the number of tiles that are loaded but tend to make
detail appear all at once after a long wait.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">20</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="material">
<a href="#material" class="doc-link"></a>
material<span class="type-signature"> : <a href="Material.html">Material</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L456">Scene/Globe.js 456</a>
</div>
</h4>
</div>
<div class="description">
Gets or sets the material appearance of the Globe. This can be one of several built-in <a href="Material.html"><code>Material</code></a> objects or a custom material, scripted with
<a href="https://github.com/CesiumGS/cesium/wiki/Fabric">Fabric</a>.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="maximumScreenSpaceError">
<a href="#maximumScreenSpaceError" class="doc-link"></a>
maximumScreenSpaceError<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L85">Scene/Globe.js 85</a>
</div>
</h4>
</div>
<div class="description">
The maximum screen-space error used to drive level-of-detail refinement. Higher
values will provide better performance but lower visual quality.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">2</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="nightFadeInDistance">
<a href="#nightFadeInDistance" class="doc-link"></a>
nightFadeInDistance<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L213">Scene/Globe.js 213</a>
</div>
</h4>
</div>
<div class="description">
The distance where the darkness of night from the ground atmosphere fades in to an unlit ground atmosphere.
This only takes effect when <code>showGroundAtmosphere</code>, <code>enableLighting</code>, and
<code>dynamicAtmosphereLighting</code> are <code>true</code>.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">50000000.0</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="nightFadeOutDistance">
<a href="#nightFadeOutDistance" class="doc-link"></a>
nightFadeOutDistance<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L203">Scene/Globe.js 203</a>
</div>
</h4>
</div>
<div class="description">
The distance where the darkness of night from the ground atmosphere fades out to a lit ground atmosphere.
This only takes effect when <code>showGroundAtmosphere</code>, <code>enableLighting</code>, and
<code>dynamicAtmosphereLighting</code> are <code>true</code>.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">10000000.0</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="oceanNormalMapUrl">
<a href="#oceanNormalMapUrl" class="doc-link"></a>
oceanNormalMapUrl<span class="type-signature"> : String</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L394">Scene/Globe.js 394</a>
</div>
</h4>
</div>
<div class="description">
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.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">buildModuleUrl('Assets/Textures/waterNormalsSmall.jpg')</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="preloadAncestors">
<a href="#preloadAncestors" class="doc-link"></a>
preloadAncestors<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L118">Scene/Globe.js 118</a>
</div>
</h4>
</div>
<div class="description">
Gets or sets a value indicating whether the ancestors of rendered tiles should be preloaded.
Setting this to true optimizes the zoom-out experience and provides more detail in
newly-exposed areas when panning. The down side is that it requires loading more tiles.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">true</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="preloadSiblings">
<a href="#preloadSiblings" class="doc-link"></a>
preloadSiblings<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L128">Scene/Globe.js 128</a>
</div>
</h4>
</div>
<div class="description">
Gets or sets a value indicating whether the siblings of rendered tiles should be preloaded.
Setting this to true causes tiles with the same parent as a rendered tile to be loaded, even
if they are culled. Setting this to true may provide a better panning experience at the
cost of loading more tiles.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">false</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="shadows">
<a href="#shadows" class="doc-link"></a>
shadows<span class="type-signature"> : <a href="ShadowMode.html">ShadowMode</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L246">Scene/Globe.js 246</a>
</div>
</h4>
</div>
<div class="description">
Determines whether the globe casts or receives shadows from light sources. 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.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">ShadowMode.RECEIVE_ONLY</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="show">
<a href="#show" class="doc-link"></a>
show<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L71">Scene/Globe.js 71</a>
</div>
</h4>
</div>
<div class="description">
Determines if the globe will be shown.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">true</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="showGroundAtmosphere">
<a href="#showGroundAtmosphere" class="doc-link"></a>
showGroundAtmosphere<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L175">Scene/Globe.js 175</a>
</div>
</h4>
</div>
<div class="description">
Enable the ground atmosphere, which is drawn over the globe when viewed from a distance between <code>lightingFadeInDistance</code> and <code>lightingFadeOutDistance</code>.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">true</code>
<h5>Demo:</h5>
<ul class="see-list">
<li><a href="https://sandcastle.cesium.com/index.html?src=Ground%2520Atmosphere.html">Ground atmosphere demo in Sandcastle</a></li>
</ul>
</dl>
<div class="nameContainer">
<h4 class="name" id="showSkirts">
<a href="#showSkirts" class="doc-link"></a>
showSkirts<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L279">Scene/Globe.js 279</a>
</div>
</h4>
</div>
<div class="description">
Whether to show terrain skirts. Terrain skirts are geometry extending downwards from a tile's edges used to hide seams between neighboring tiles.
It may be desirable to hide terrain skirts if terrain is translucent or when viewing terrain from below the surface.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">true</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="showWaterEffect">
<a href="#showWaterEffect" class="doc-link"></a>
showWaterEffect<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L223">Scene/Globe.js 223</a>
</div>
</h4>
</div>
<div class="description">
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
<code>terrainProvider</code> does not provide a water mask.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">true</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="terrainProvider">
<a href="#terrainProvider" class="doc-link"></a>
terrainProvider<span class="type-signature"> : <a href="TerrainProvider.html">TerrainProvider</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L411">Scene/Globe.js 411</a>
</div>
</h4>
</div>
<div class="description">
The terrain provider providing surface geometry for this globe.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="terrainProviderChanged">
<a href="#terrainProviderChanged" class="doc-link"></a>
<span class="type-signature attribute-readonly">readonly</span>terrainProviderChanged<span class="type-signature"> : <a href="Event.html">Event</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L432">Scene/Globe.js 432</a>
</div>
</h4>
</div>
<div class="description">
Gets an event that's raised when the terrain provider is changed
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="tileCacheSize">
<a href="#tileCacheSize" class="doc-link"></a>
tileCacheSize<span class="type-signature"> : Number</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L96">Scene/Globe.js 96</a>
</div>
</h4>
</div>
<div class="description">
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.
</div>
<dl class="details">
<span class="details-header">Default Value:</span>
<code class="language-javascript">100</code>
</dl>
<div class="nameContainer">
<h4 class="name" id="tileLoadProgressEvent">
<a href="#tileLoadProgressEvent" class="doc-link"></a>
tileLoadProgressEvent<span class="type-signature"> : <a href="Event.html">Event</a></span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L444">Scene/Globe.js 444</a>
</div>
</h4>
</div>
<div class="description">
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.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="tilesLoaded">
<a href="#tilesLoaded" class="doc-link"></a>
<span class="type-signature attribute-readonly">readonly</span>tilesLoaded<span class="type-signature"> : Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L333">Scene/Globe.js 333</a>
</div>
</h4>
</div>
<div class="description">
Returns <code>true</code> when the tile load queue is empty, <code>false</code> otherwise. When the load queue is empty,
all terrain and imagery for the current view have been loaded.
</div>
<dl class="details">
</dl>
<h3 class="subsection-title">Methods</h3>
<div class="nameContainer">
<h4 class="name" id="destroy">
<a href="#destroy" class="doc-link"></a>
destroy<span class="signature">()</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L852">Scene/Globe.js 852</a>
</div>
</h4>
</div>
<div class="description">
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.
<br /><br />
Once an object is destroyed, it should not be used; calling any function other than
<code>isDestroyed</code> will result in a <a href="DeveloperError.html"><code>DeveloperError</code></a> exception. Therefore,
assign the return value (<code>undefined</code>) to the object as done in the example.
</div>
<h5>Throws:</h5>
<ul>
<li>
<div class="param-desc">
<span class="param-type"><a href="DeveloperError.html">DeveloperError</a></span>
: This object was destroyed, i.e., destroy() was called.
</div>
</li>
</ul>
<dl class="details">
<h5>Example:</h5>
<pre><code class="language-javascript">globe = globe &amp;&amp; globe.destroy();</code></pre>
<h5>See:</h5>
<ul class="see-list">
<li><a href="Globe.html#isDestroyed">Globe#isDestroyed</a></li>
</ul>
</dl>
<div class="nameContainer">
<h4 class="name" id="getHeight">
<a href="#getHeight" class="doc-link"></a>
getHeight<span class="signature">(cartographic)</span> &rarr; <span class="type-signature returnType">Number|undefined</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L622">Scene/Globe.js 622</a>
</div>
</h4>
</div>
<div class="description">
Get the height of the surface at a given cartographic.
</div>
<table class="params">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th class="last">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td class="name"><code>cartographic</code></td>
<td class="type">
<span class="param-type"><a href="Cartographic.html">Cartographic</a></span>
</td>
<td class="description last">
The cartographic for which to find the height.</td>
</tr>
</tbody>
</table>
<h5>Returns:</h5>
<div class="param-desc">
The height of the cartographic or undefined if it could not be found.
</div>
<dl class="details">
</dl>
<div class="nameContainer">
<h4 class="name" id="isDestroyed">
<a href="#isDestroyed" class="doc-link"></a>
isDestroyed<span class="signature">()</span> &rarr; <span class="type-signature returnType">Boolean</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L832">Scene/Globe.js 832</a>
</div>
</h4>
</div>
<div class="description">
Returns true if this object was destroyed; otherwise, false.
<br /><br />
If this object was destroyed, it should not be used; calling any function other than
<code>isDestroyed</code> will result in a <a href="DeveloperError.html"><code>DeveloperError</code></a> exception.
</div>
<h5>Returns:</h5>
<div class="param-desc">
True if this object was destroyed; otherwise, false.
</div>
<dl class="details">
<h5>See:</h5>
<ul class="see-list">
<li><a href="Globe.html#destroy">Globe#destroy</a></li>
</ul>
</dl>
<div class="nameContainer">
<h4 class="name" id="pick">
<a href="#pick" class="doc-link"></a>
pick<span class="signature">(ray, scene, <span class="optional">result</span>)</span> &rarr; <span class="type-signature returnType"><a href="Cartesian3.html">Cartesian3</a>|undefined</span>
<div class="source-link rightLinks">
<a href="https://github.com/CesiumGS/cesium/blob/1.68/Source/Scene/Globe.js#L596">Scene/Globe.js 596</a>
</div>
</h4>
</div>
<div class="description">
Find an intersection between a ray and the globe surface that was rendered. The ray must be given in world coordinates.
</div>
<table class="params">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th class="last">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td class="name"><code>ray</code></td>
<td class="type">
<span class="param-type"><a href="Ray.html">Ray</a></span>
</td>
<td class="description last">
The ray to test for intersection.</td>
</tr>
<tr>
<td class="name"><code>scene</code></td>
<td class="type">
<span class="param-type"><a href="Scene.html">Scene</a></span>
</td>
<td class="description last">
The scene.</td>
</tr>
<tr>
<td class="name"><code>result</code></td>
<td class="type">
<span class="param-type"><a href="Cartesian3.html">Cartesian3</a></span>
</td>
<td class="description last">
<span class="optional">optional</span>
The object onto which to store the result.</td>
</tr>
</tbody>
</table>
<h5>Returns:</h5>
<div class="param-desc">
The intersection or <code>undefined</code> if none was found.
</div>
<dl class="details">
<h5>Example:</h5>
<pre><code class="language-javascript">// find intersection of ray through a pixel and the globe
var ray = viewer.camera.getPickRay(windowCoordinates);
var intersection = globe.pick(ray, scene);</code></pre>
</dl>
</article>
</section>
<footer>
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a>
</footer>
</div>
<div class="nav">
<div class="menu">
<input type="text" class="classFilter" id="ClassFilter" placeholder="Search">
<ul id="ClassList"><li data-name="Animation"><a href="Animation.html">Animation</a></li><li data-name="AnimationViewModel"><a href="AnimationViewModel.html">AnimationViewModel</a></li><li data-name="Appearance"><a href="Appearance.html">Appearance</a></li><li data-name="ArcGisMapServerImageryProvider"><a href="ArcGisMapServerImageryProvider.html">ArcGisMapServerImageryProvider</a></li><li data-name="ArcGISTiledElevationTerrainProvider"><a href="ArcGISTiledElevationTerrainProvider.html">ArcGISTiledElevationTerrainProvider</a></li><li data-name="ArcType"><a href="ArcType.html">ArcType</a></li><li data-name="AssociativeArray"><a href="AssociativeArray.html">AssociativeArray</a></li><li data-name="AxisAlignedBoundingBox"><a href="AxisAlignedBoundingBox.html">AxisAlignedBoundingBox</a></li><li data-name="barycentricCoordinates"><a href="barycentricCoordinates.html">barycentricCoordinates</a></li><li data-name="BaseLayerPicker"><a href="BaseLayerPicker.html">BaseLayerPicker</a></li><li data-name="BaseLayerPickerViewModel"><a href="BaseLayerPickerViewModel.html">BaseLayerPickerViewModel</a></li><li data-name="Billboard"><a href="Billboard.html">Billboard</a></li><li data-name="BillboardCollection"><a href="BillboardCollection.html">BillboardCollection</a></li><li data-name="BillboardGraphics"><a href="BillboardGraphics.html">BillboardGraphics</a></li><li data-name="BillboardVisualizer"><a href="BillboardVisualizer.html">BillboardVisualizer</a></li><li data-name="binarySearch"><a href="binarySearch.html">binarySearch</a></li><li data-name="BingMapsApi"><a href="BingMapsApi.html">BingMapsApi</a></li><li data-name="BingMapsGeocoderService"><a href="BingMapsGeocoderService.html">BingMapsGeocoderService</a></li><li data-name="BingMapsImageryProvider"><a href="BingMapsImageryProvider.html">BingMapsImageryProvider</a></li><li data-name="BingMapsStyle"><a href="BingMapsStyle.html">BingMapsStyle</a></li><li data-name="BlendEquation"><a href="BlendEquation.html">BlendEquation</a></li><li data-name="BlendFunction"><a href="BlendFunction.html">BlendFunction</a></li><li data-name="BlendingState"><a href="BlendingState.html">BlendingState</a></li><li data-name="BlendOption"><a href="BlendOption.html">BlendOption</a></li><li data-name="BoundingRectangle"><a href="BoundingRectangle.html">BoundingRectangle</a></li><li data-name="BoundingSphere"><a href="BoundingSphere.html">BoundingSphere</a></li><li data-name="BoxEmitter"><a href="BoxEmitter.html">BoxEmitter</a></li><li data-name="BoxGeometry"><a href="BoxGeometry.html">BoxGeometry</a></li><li data-name="BoxGeometryUpdater"><a href="BoxGeometryUpdater.html">BoxGeometryUpdater</a></li><li data-name="BoxGraphics"><a href="BoxGraphics.html">BoxGraphics</a></li><li data-name="BoxOutlineGeometry"><a href="BoxOutlineGeometry.html">BoxOutlineGeometry</a></li><li data-name="CallbackProperty"><a href="CallbackProperty.html">CallbackProperty</a></li><li data-name="Camera"><a href="Camera.html">Camera</a></li><li data-name="CameraEventAggregator"><a href="CameraEventAggregator.html">CameraEventAggregator</a></li><li data-name="CameraEventType"><a href="CameraEventType.html">CameraEventType</a></li><li data-name="cancelAnimationFrame"><a href="cancelAnimationFrame.html">cancelAnimationFrame</a></li><li data-name="Cartesian2"><a href="Cartesian2.html">Cartesian2</a></li><li data-name="Cartesian3"><a href="Cartesian3.html">Cartesian3</a></li><li data-name="Cartesian4"><a href="Cartesian4.html">Cartesian4</a></li><li data-name="Cartographic"><a href="Cartographic.html">Cartographic</a></li><li data-name="CartographicGeocoderService"><a href="CartographicGeocoderService.html">CartographicGeocoderService</a></li><li data-name="CatmullRomSpline"><a href="CatmullRomSpline.html">CatmullRomSpline</a></li><li data-name="Cesium3DTile"><a href="Cesium3DTile.html">Cesium3DTile</a></li><li data-name="Cesium3DTileColorBlendMode"><a href="Cesium3DTileColorBlendMode.html">Cesium3DTileColorBlendMode</a></li><li data-name="Cesium3DTileContent"><a href="Cesium3DTileContent.html">Cesium3DTileContent</a></li><li data-
</div>
</div>
<script>
if (window.frameElement) {
document.body.className = 'embedded';
var ele = document.createElement('a');
ele.className = 'popout';
ele.target = '_blank';
ele.href = window.location.href;
ele.title = 'Pop out';
document.getElementById('main').appendChild(ele);
}
// Set targets on external links. Sandcastle and GitHub shouldn't be embedded in any iframe.
Array.prototype.forEach.call(document.getElementsByTagName('a'), function(a) {
if (/^https?:/i.test(a.getAttribute('href'))) {
a.target='_blank';
}
});
</script>
<script src="javascript/prism.js"></script>
<script src="javascript/cesiumDoc.js"></script>
</body>
</html>