| Name | Type | Default | Description |
|---|---|---|---|
ellipsoid |
Ellipsoid |
Ellipsoid.default
|
optional 确定地球的大小和形状。 |
Members
应用于大气的亮度偏移。默认为 0.0（无偏移）。
亮度偏移为 -1.0 表示完全黑暗，这将使空间显示出来。
-
Default Value:
0.0
应用于大气的色调偏移。默认为 0.0（无偏移）。
色调偏移为 1.0 表示可用色调的完整旋转。
-
Default Value:
0.0
用于计算地面大气颜色的光照强度。
-
Default Value:
10.0
进行米散射时考虑的介质的各向异性。
有效值在 -1.0 和 1.0 之间。
-
Default Value:
0.9
atmosphereMieCoefficient : Cartesian3
在地面大气的散射方程中使用的米散射系数。
-
Default Value:
Cartesian3(21e-6, 21e-6, 21e-6)
在地面大气的散射方程中使用的米尺度高度，以米为单位。
-
Default Value:
3200.0
atmosphereRayleighCoefficient : Cartesian3
在地面大气的散射方程中使用的瑞利散射系数。
-
Default Value:
Cartesian3(5.5e-6, 13.0e-6, 28.4e-6)
在地面大气的散射方程中使用的瑞利尺度高度，以米为单位。
-
Default Value:
10000.0
应用于大气的饱和度偏移。默认为 0.0（无偏移）。
饱和度偏移为 -1.0 表示单色。
-
Default Value:
0.0
是否剔除背面地形。当相机位于地下或启用透明度时，背面不被剔除。
-
Default Value:
true
baseColor : Color
获取或设置在没有影像可用时地球的颜色。
cartographicLimitRectangle : Rectangle
指定一个
Rectangle 的属性，用于限制地球的渲染到一个大地区域。
默认为大地坐标的最大范围。
-
Default Value:
Rectangle.MAX_VALUEclippingPlanes : ClippingPlaneCollection
指定一个
ClippingPlaneCollection 的属性，用于选择性地禁用每个平面外部的渲染。
clippingPolygons : ClippingPolygonCollection
指定一个
ClippingPolygonCollection 的属性，用于选择性地禁用在一组多边形内部或外部的渲染。
如果诸如广告牌、多边线、标签等图元应与地形表面进行深度测试，则为真；如果这些图元应始终绘制在地形之上（除非它们在地球的另一侧），则为假。对地形进行深度测试的缺点是，细微的数值噪声或地形细节层次切换有时会使本应在表面的图元消失在其下方。
-
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
获取一个事件，每当图像层被添加、显示、隐藏、移动或移除时触发。
用于调整地形兰伯特光照的倍增器。
此数字乘以 GlobeFS.glsl 中
czm_getLambertDiffuse 的结果。
仅当 enableLighting 为 true 时才生效。
-
Default Value:
0.9
照明恢复的距离。仅在
enableLighting 或 showGroundAtmosphere 为 true 时生效。
-
Default Value:
pi * ellipsoid.minimumRadius
所有物体被照亮的距离。仅在
enableLighting 或 showGroundAtmosphere 为 true 时生效。
-
Default Value:
1/2 * pi * ellipsoid.minimumRadius
获取或设置被认为“太多”的正在加载的子瓦片数量。
如果一个瓦片有太多正在加载的子瓦片，该瓦片将在其任何子瓦片被加载和渲染之前被加载和渲染。
这意味着用户可以更快地收到反馈，表明正在发生某些事情，但总体加载时间会延长。
将该值设置为 0 会导致每个
瓦片层被依次加载，显著增加加载时间。将其设置为较大的
数字（例如 1000）将最小化加载的瓦片数量，但往往会使
细节在长时间等待后一次性出现。
-
Default Value:
20
material : Material|undefined
用于驱动细节层次优化的最大屏幕空间误差。更高的
值将提供更好的性能，但视觉质量较低。
-
Default Value:
2
从地面大气中夜间黑暗淡化为未照亮的地面大气的距离。
仅在
showGroundAtmosphere、enableLighting 和
dynamicAtmosphereLighting 为 true 时生效。
-
Default Value:
5/2 * pi * ellipsoid.minimumRadius
从地面大气中夜间黑暗淡化为亮的地面大气的距离。
仅在
showGroundAtmosphere、enableLighting 和
dynamicAtmosphereLighting 为 true 时生效。
-
Default Value:
1/2 * pi * ellipsoid.minimumRadius
用于在海洋中渲染波浪的法线贴图。设置此属性
仅在配置的地形提供者包含水面掩码时才有效。
-
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:
在使用 WGS84 椭球体时为 true，其他情况下为 false
是否显示地形裙边。地形裙边是从瓦片边缘向下延伸的几何体，用于隐藏相邻瓦片之间的接缝。
当相机位于地下或启用透明度时，裙边总是隐藏。
-
Default Value:
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.BLACKSee:
undergroundColorAlphaByDistance : NearFarScalar
获取或设置用于混合
当相机位于椭球体上方时，距离是从椭球体上最近的点计算，而不是相机的位置。
Globe#undergroundColor 与地球颜色的近距离和远距离。
当相机距离在指定的 NearFarScalar#near 和 NearFarScalar#far 范围内时，alpha 会在
NearFarScalar#nearValue 和 NearFarScalar#farValue 之间进行插值。
在这些范围之外，alpha 保持在离最近的边界。如果未定义，
地下颜色将不会与地球颜色混合。
当相机位于椭球体上方时，距离是从椭球体上最近的点计算，而不是相机的位置。
确定顶点阴影的暗度。
仅在
enableLighting 为 true 时生效。
-
Default Value:
0.3
Methods
销毁此对象持有的 WebGL 资源。销毁对象可以实现 WebGL 资源的可预测释放，而不是依靠垃圾回收器来销毁此对象。
一旦对象被销毁，则不应再使用；调用除
一旦对象被销毁，则不应再使用；调用除
isDestroyed 之外的任何函数将导致 DeveloperError 异常。因此，
将返回值（undefined）分配给该对象，如示例中所示。
Throws:
-
DeveloperError : 此对象已被销毁，即调用了 destroy()。
Example:
globe = globe && globe.destroy();See:
获取给定大地坐标处表面的高度。
| Name | Type | Description |
|---|---|---|
cartographic |
Cartographic | 要查找高度的大地坐标。 |
Returns:
大地坐标的高度，如果未找到则返回 undefined。
Returns:
如果此对象已被销毁，则返回 true；否则返回 false。
See:
pick(ray, scene, result) → Cartesian3|undefined
找到光线与已渲染的地球表面之间的交点。光线必须以世界坐标给出。
| Name | Type | Description |
|---|---|---|
ray |
Ray | 要测试交点的光线。 |
scene |
Scene | 场景。 |
result |
Cartesian3 | optional 存储结果的对象。 |
Returns:
交点或
undefined 如果未找到交点。
Example:
// find intersection of ray through a pixel and the globe
const ray = viewer.camera.getPickRay(windowCoordinates);
const intersection = globe.pick(ray, scene);