| 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 属性。
如果图元（如广告牌、折线、标签等）应针对地形表面进行深度测试则为 true，
如果此类图元应始终绘制在地形上方（除非它们位于地球的另一侧）则为 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
获取添加、显示、隐藏、移动或移除影像图层时触发的事件。
用于调整地形漫反射光照的乘数。
该数字与 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
如果在地球被水覆盖的区域显示动画波纹效果则为 true；否则为 false。
如果
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:
// 查找穿过像素的射线与地球的交点
const ray = viewer.camera.getPickRay(windowCoordinates);
const intersection = globe.pick(ray, scene);