| Name | Type | Default | Description |
|---|---|---|---|
ellipsoid |
Ellipsoid |
Ellipsoid.WGS84
|
optional 确定地球的尺寸和形状。 |
Members
应用于大气层的亮度偏移。默认为0.0（无偏移）。值域为-1.0——1.0。
-
Default Value:
0.0
应用于大气层的色调偏移。默认为0.0（无偏移）。值域为-1.0——1.0。
-
Default Value:
0.0
应用于大气层的饱和度偏移。默认为0.0（无偏移）。值域为-1.0——1.0。
-
Default Value:
0.0
baseColor : Color
获取或设置在没有可用图像时地球的颜色。
clippingPlanes : ClippingPlaneCollection
指定
ClippingPlaneCollection的属性，用于有选择地在每个平面外部的禁用渲染。
是否开启深度测试。
如果布告牌、折线、标签等图元需要在地形表面上进行深度测试，则为true；如果这些图元需要在地形表面上绘制，则为false，除非它们位于地球的另一端。
地形深度测试针对于图元的缺点是，轻微的数字噪声或地形细节级别转换有时会使本应在表面的图元消失在其下面。
-
Default Value:
false
ellipsoid : Ellipsoid
获取描述地球形状的椭球。
是否启用太阳光照。
-
Default Value:
false
fillHighlightColor : Color
用于高亮显示地形填充瓦片的颜色。如果未定义，填充瓦片将完全不高光显示。alpha值用于和瓦片的实际颜色进行alpha混合。
由于地形填充瓦片并不代表实际的地形表面，因此在某些应用程序中，在视觉上表示它们不可信可能会很有用。
-
Default Value:
undefined
imageryLayers : ImageryLayerCollection
获取将在地球上渲染的图像图层的集合。
readonlyimageryLayersUpdatedEvent : 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
显示黑夜最大距离。
当设置
enableLighting或showGroundAtmosphere为true时，才起作用。
-
Default Value:
50000000.0
显示黑夜最小距离。
当设置
enableLighting或showGroundAtmosphere为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
是否启用地面大气，如果为true，在
lightingFadeInDistance和lightingFadeOutDistance之间，它会在全球范围内被绘制。
-
Default Value:
true
Demo:
如果应该在地球上被水覆盖的地区显示出动态的波浪效果，则为true；否则，false。
如果
terrainProvider不提供水掩膜，则忽略此属性。
-
Default Value:
true
terrainProvider : TerrainProvider
地形提供器为地球提供表面几何图形。
readonlyterrainProviderChanged : Event
获取地形提供器改变时触发的事件。
地形瓦片缓存的大小，表示瓦片的数量。
不需要在当前帧渲染的，且超出这个数字的地形瓦片将会被释放。
数字越大将会占用越多的内存，但是显示细节更快（例如快速放大缩小时）。
-
Default Value:
100
tileLoadProgressEvent : Event
获取一个事件，该事件在瓦片加载队列的长度自上一个渲染帧以来发生更改时引发。
当加载队列为空时，当前视图的所有地形和图像均已加载。该事件传递瓦片加载队列的新长度。
当瓦片加载队列为空时返回
true，否则false。
当加载队列为空时，当前视图的所有地形和图像都已加载。
Methods
销毁此对象持有的WebGL资源。
一旦对象被销毁，它将不能在使用；调用除
一旦对象被销毁，它将不能在使用；调用除
isDestroyed之外的任何函数都会导致DeveloperError异常。
因此，将返回值(undefined)赋给对象，如示例所示。
Throws:
-
DeveloperError : 这个对象被销毁了，即，destroy()被调用。
Example:
globe = globe && globe.destroy();See:
在给定的地理坐标上获得地球表面的高度。
| Name | Type | Description |
|---|---|---|
cartographic |
Cartographic | 求高度的地理坐标。 |
Returns:
给定地理坐标处的高度，如果没有找到，则为未定义。
Returns:
false。
See:
pick(ray, scene, result) → Cartesian3|undefined
拾取射线与地球表面的交点。射线必须以世界坐标表示。
| Name | Type | Description |
|---|---|---|
ray |
Ray | 用于测试相交的射线。 |
scene |
Scene | 场景。 |
result |
Cartesian3 | optional 存储结果的对象。 |
Returns:
交点，若没有找到则为
undefined。
Example:
// 通过一个像素求射线与地球的交点
var ray = viewer.camera.getPickRay(windowCoordinates);
var intersection = globe.pick(ray, scene);