| Name | Type | Default | Description |
|---|---|---|---|
ellipsoid
|
Ellipsoid |
Ellipsoid.WGS84
|
可选 确定尺寸和形状地球。 |
Members
亮度变化适用于大气。默认为0.0（无移位）。-1.0的亮度偏移是完全黑暗，这将使空间显示出来。
-
Default Value:
0.0
色调变化适用于大气。默认为0.0（无移位）。色相偏移1.0表示可用色相完全旋转。
-
Default Value:
0.0
饱和度偏移将应用于大气。默认为0.0（无移位）。-1.0的饱和度偏移是单色的。
-
Default Value:
0.0
是否选择背面地形。当相机在地下或启用了半透明功能时，背面不会被剔除。
-
Default Value:
true
baseColor : Color
在没有可用图像时获取或设置地球的颜色。
cartographicLimitRectangle : Rectangle
一个指定
Rectangle
的属性，用于将地球仪渲染限制在制图区域。默认为地图坐标的最大范围。
-
Default Value:
Rectangle.MAX_VALUE
clippingPlanes : ClippingPlaneCollection
指定
ClippingPlaneCollection
的属性，用于有选择地禁用每个平面外部的渲染。
如果应对广告牌，折线，标签等图元进行深度测试，则为真抵靠地形表面；如果应始终将此类图元绘制在顶部，则为false除非它们位于地球的另一侧。深度的缺点针对图元测试图元是轻微的数值噪声或图面细节级别切换有时会使应该在表面上的图元消失在其下方。
-
Default Value:
false
对大气和雾启用动态照明效果。这只会生效当
enableLighting
为
true
时。
-
Default Value:
true
动态气氛照明是否使用太阳方向而不是场景的方向灯光方向。仅在
enableLighting
和
dynamicAtmosphereLighting
是
true
。
-
Default Value:
false
ellipsoid : Ellipsoid
获取描述此地球形状的椭圆体。
启用使用场景的光源为地球照明。
-
Default Value:
false
fillHighlightColor : Color
用于突出显示地形填充图块的颜色。如果未定义，则填充图块不突出显示。 Alpha值用于与图块的Alpha混合实际颜色。由于地形填充图块不代表实际的地形表面，在某些应用程序中直观地表明它们不受信任可能会很有用。
-
Default Value:
undefined
imageryLayers : ImageryLayerCollection
获取将在此地球上渲染的图像图层的集合。
readonly imageryLayersUpdatedEvent : Event
获取在添加，显示，隐藏，移动或删除图像图层时引发的事件。
恢复照明的距离。这只会生效当
enableLighting
或
showGroundAtmosphere
为
true
时。
-
Default Value:
20000000.0
一切都变亮的距离。这只会生效当
enableLighting
或
showGroundAtmosphere
为
true
时。
-
Default Value:
10000000.0
获取或设置被视为'太多'的加载后代切片的数量。如果某个图块的加载后代过多，则该图块将在任何它的后代将被加载和渲染。这意味着更多的反馈给用户以较长的整体加载时间为代价进行操作。设置为0将导致每个要连续加载的图块级别，显着增加了加载时间。设置大数量（例如1000）将最大限度地减少已加载但易于生成的图块数量经过漫长的等待，细节立即全部出现。
-
Default Value:
20
material : Material
用于驱动细节级别细化的最大屏幕空间错误。更高值将提供更好的性能，但降低视觉质量。
-
Default Value:
2
夜晚的黑暗从地面大气逐渐消失到昏暗的地面大气的距离。仅当
showGroundAtmosphere
，
enableLighting
和
dynamicAtmosphereLighting
是
true
。
-
Default Value:
50000000.0
夜晚的黑暗从地面大气逐渐消失到明亮的地面大气的距离。仅当
showGroundAtmosphere
，
enableLighting
和
dynamicAtmosphereLighting
是
true
。
-
Default Value:
10000000.0
用于在海洋中渲染波浪的法线贴图。设置此属性将仅在配置的地形提供程序包括水罩的情况下才起作用。
-
Default Value:
buildModuleUrl('Assets/Textures/waterNormalsSmall.jpg')
获取或设置一个值，该值指示是否应预加载渲染图块的祖先。将此设置为true可优化缩小体验，并在平移时新暴露的区域。不利的一面是，它需要加载更多的图块。
-
Default Value:
true
获取或设置一个值，该值指示是否应预加载渲染图块的同级。将此设置为true会导致加载与渲染图块具有相同父级图块的图块，即使如果他们被淘汰。将此设置为true可能会提供更好的平移体验加载更多瓷砖的成本。
-
Default Value:
false
shadows : ShadowMode
确定地球是否投射或接收来自光源的阴影。设置地球投射阴影可能会影响性能，因为从灯光的角度重新渲染了地形。当前，只有可见的地形会投射阴影。默认情况下，地球仪不会投射阴影。
-
Default Value:
ShadowMode.RECEIVE_ONLY
确定是否显示地球。
-
Default Value:
true
启用从
lightingFadeInDistance
和
lightingFadeOutDistance
之间的距离观察时绘制在地球上的地面大气。
-
Default Value:
true
Demo:
是否显示地形裙子。地形裙板是从砖的边缘向下延伸的几何形状，用于隐藏相邻砖之间的接缝。当照相机在地下或启用了半透明时，裙子总是隐藏的。
-
Default Value:
true
如果应在全球范围内显示动画波浪效果，则为true被水覆盖；否则为假。如果
terrainProvider
不提供水面罩。
-
Default Value:
true
terrainProvider : TerrainProvider
地形提供者为该地球仪提供了表面几何形状。
readonly terrainProviderChanged : Event
获取更改地形提供者时引发的事件
地形图块缓存的大小，表示为图块数。任何其他只要不需要渲染，就会释放超出此数目的图块这个框架。较大的数字将消耗更多的内存，但显示细节更快例如，当缩小然后再放大时。
-
Default Value:
100
tileLoadProgressEvent : Event
获取自上一个渲染帧以来切片加载队列的长度发生更改时引发的事件。当加载队列为空时，当前视图的所有地形和图像均已加载。该事件将传递图块加载队列的新长度。
当图块加载队列为空时，返回
true
，否则返回
false
。当加载队列为空时，当前视图的所有地形和图像均已加载。
translucency : GlobeTranslucency
用于控制地球透明度的属性。
undergroundColor : Color
当照相机在地下或地球仪是半透明的时，呈现地球仪背面的颜色，根据相机的距离与地球色混合。
要禁用地下着色，请将
要禁用地下着色，请将
undergroundColor
设置为
undefined
。
-
Default Value:
Color.BLACK
See:
undergroundColorAlphaByDistance : NearFarScalar
获取或设置将
当相机在椭球上方时，距离是从最近的指向椭圆形而不是相机的位置。
Globe＃undergroundColor
与地球色混合的近距离和远距离。Alpha将在
NearFarScalar＃nearValue
和
NearFarScalar＃farValue
，而摄像头距离在上下限之内指定的
NearFarScalar＃near
和
NearFarScalar＃far 代码>
。在这些范围之外，alpha仍会固定在最近的范围内。如果未定义，地下颜色将不会与地球颜色混合。
当相机在椭球上方时，距离是从最近的指向椭圆形而不是相机的位置。
Methods
销毁此对象拥有的WebGL资源。销毁对象可以确定性释放WebGL资源，而不是依赖垃圾回收器破坏此对象。
一旦物体被破坏，就不应使用。调用除
一旦物体被破坏，就不应使用。调用除
isDestroyed
将导致
DeveloperError
异常。因此，如示例中所述，将返回值（
undefined
）分配给对象。
Throws:
-
DeveloperError :此对象已销毁，即调用destroy（）。
Example:
globe = globe && globe.destroy();See:
获取给定制图上的表面高度。
| Name | Type | Description |
|---|---|---|
cartographic
|
Cartographic | 要查找高度的地图。 |
Returns:
制图的高度，如果找不到则未定义。
Returns:
如果该对象被破坏，则为true；否则为false。否则为假。
See:
pick (ray, scene, result ) → Cartesian3 |undefined
找到射线与渲染的地球表面之间的交点。射线必须以世界坐标给出。
| Name | Type | Description |
|---|---|---|
ray
|
Ray | 用于测试相交的射线。 |
scene
|
Scene | 现场。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
交点或
未定义
如果没有找到。
Example:
// find intersection of ray through a pixel and the globe
var ray = viewer.camera.getPickRay(windowCoordinates);
var intersection = globe.pick(ray, scene);