Globe

new Cesium.Globe(ellipsoid)
Scene/Globe.js 42

场景中渲染的地球，包括其地形（Globe#terrainProvider） 以及图像层（Globe#imageryLayers）。使用Scene#globe访问全球。
Name Type Default Description
ellipsoid Ellipsoid Ellipsoid.WGS84 optional 确定 地球仪。

Members

atmosphereBrightnessShift : Number
Scene/Globe.js 283

应用于大气的亮度偏移。默认为0.0（无移位）。 亮度偏移-1.0是完全黑暗的，这将使空间显现出来。
Default Value: 0.0

atmosphereHueShift : Number
Scene/Globe.js 267

应用于大气的色调变化。默认为0.0（无移位）。 色调偏移1.0表示可用色调的完全旋转。
Default Value: 0.0

atmosphereSaturationShift : Number
Scene/Globe.js 275

适用于大气的饱和位移。默认为0.0（无移位）。 饱和度偏移-1.0是单色的。
Default Value: 0.0

backFaceCulling : Boolean
Scene/Globe.js 300

是否剔除后向地形。当摄影机位于地下或启用半透明时，不会剔除背面。
Default Value: true

baseColor : Color
Scene/Globe.js 364

获取或设置没有可用图像时的全局颜色。

cartographicLimitRectangle : Rectangle
Scene/Globe.js 394

一种指定Rectangle的属性，用于将全局渲染限制在绘图区域内。 默认为地图坐标的最大范围。
Default Value: Rectangle.MAX_VALUE

clippingPlanes : ClippingPlaneCollection
Scene/Globe.js 378

指定ClippingPlaneCollection的属性，用于有选择地禁用每个平面外部的渲染。

depthTestAgainstTerrain : Boolean
Scene/Globe.js 249

如果基本体（如广告牌、多段线、标签等）应进行深度测试，则为True 如果这些基本体始终绘制在顶部，则为假 除非他们在地球的另一边。深度的缺点 在地形上测试原语是指轻微的数字噪声或地形的详细程度 切换有时会使应位于曲面上的基本体在其下方消失。
Default Value: false

dynamicAtmosphereLighting : Boolean
Scene/Globe.js 168

对大气和雾启用动态照明效果。这只会生效 当enableLighting是true时。
Default Value: true

dynamicAtmosphereLightingFromSun : Boolean
Scene/Globe.js 178

动态大气照明是否使用太阳方向而不是场景的方向 灯光方向。仅当enableLighting和 dynamicAtmosphereLighting是true。
Default Value: false

ellipsoid : Ellipsoid
Scene/Globe.js 312

获取描述此球体形状的椭球体。

enableLighting : Boolean
Scene/Globe.js 159

启用使用场景光源照明球体。
Default Value: false

fillHighlightColor : Color
Scene/Globe.js 151

用于高亮显示地形填充瓷砖的颜色。如果未定义，填充瓷砖不存在 完全突出显示。alpha值用于alpha与瓷砖的混合 实际颜色。因为地形填充砖不代表实际的地形表面， 在某些应用程序中，直观地表明它们不受信任可能很有用。
Default Value: undefined

imageryLayers : ImageryLayerCollection
Scene/Globe.js 322

获取将在此球体上呈现的图像层的集合。

readonly imageryLayersUpdatedEvent : Event
Scene/Globe.js 334

获取在添加、显示、隐藏、移动或移除图像层时引发的事件。

lightingFadeInDistance : Number
Scene/Globe.js 206

恢复照明的距离。这只会生效 当enableLighting或showGroundAtmosphere是true时。
Default Value: 20000000.0

lightingFadeOutDistance : Number
Scene/Globe.js 197

一切都变亮的距离。这只会生效 当enableLighting或showGroundAtmosphere是true时。
Default Value: 10000000.0

loadingDescendantLimit : Number
Scene/Globe.js 122

获取或设置被认为“太多”的加载子体分片的数目。 如果一个分片有太多的加载子体，则该分片将在 加载并渲染其子体。这意味着对用户有更多的反馈 以较长的总加载时间为代价。将此设置为0将导致 平铺层要连续加载，显著增加加载时间。设置为大 数字（例如1000）将使加载的瓷砖数量最小化，但往往 经过长时间的等待，细节一下子出现了。
Default Value: 20

material : Material
Scene/Globe.js 474

获取或设置地球仪的材质外观。它可以是几个内置的Material对象中的一个，也可以是一个自定义材质，用 Fabric

maximumScreenSpaceError : Number
Scene/Globe.js 98

用于驱动详细程度细化的最大屏幕空间错误。较高的 值将提供更好的性能，但视觉质量较低。
Default Value: 2

nightFadeInDistance : Number
Scene/Globe.js 226

黑夜从地面大气层逐渐消失到没有照明的地面大气的距离。 仅当showGroundAtmosphere、enableLighting和 dynamicAtmosphereLighting是true。
Default Value: 50000000.0

nightFadeOutDistance : Number
Scene/Globe.js 216

夜色从地面大气逐渐消失到地面大气的距离。 仅当showGroundAtmosphere、enableLighting和 dynamicAtmosphereLighting是true。
Default Value: 10000000.0

oceanNormalMapUrl : String
Scene/Globe.js 412

用于渲染海洋中波浪的法线贴图。设置此属性将 仅当配置的地形提供程序包含水遮罩时才有效。
Default Value: buildModuleUrl('Assets/Textures/waterNormalsSmall.jpg')

preloadAncestors : Boolean
Scene/Globe.js 131

获取或设置一个值，该值指示是否应预加载呈现平铺的祖先。 将此设置为true可优化缩小体验，并在中提供更多详细信息 平移时新暴露的区域。缺点是它需要加载更多的瓷砖。
Default Value: true

preloadSiblings : Boolean
Scene/Globe.js 141

获取或设置一个值，该值指示是否应预加载呈现平铺的同级。 将此设置为true将导致加载与渲染平铺具有相同父级的平铺 如果他们被淘汰。将此设置为true可以在 装载更多瓷砖的成本。
Default Value: false

shadows : ShadowMode
Scene/Globe.js 259

确定球体是投射还是接收来自光源的阴影。设置地球仪 投射阴影可能会影响性能，因为从灯光的角度再次渲染地形。 当前只有视图中的地形投射阴影。默认情况下，球体不投射阴影。
Default Value: ShadowMode.RECEIVE_ONLY

show : Boolean
Scene/Globe.js 84

确定是否显示地球仪。
Default Value: true

showGroundAtmosphere : Boolean
Scene/Globe.js 188

启用地面大气，当从lightingFadeInDistance和lightingFadeOutDistance之间的距离观看时，将在地球上绘制地面大气。
Default Value: true
Demo:

showSkirts : Boolean
Scene/Globe.js 292

是否显示地形裙板。地形边缘是从瓷砖边缘向下延伸的几何体，用于隐藏相邻瓷砖之间的接缝。 当摄影机位于地下或启用“半透明”时，裙子始终处于隐藏状态。
Default Value: true

showWaterEffect : Boolean
Scene/Globe.js 236

如果动画波浪效果应显示在全球范围内，则为True 被水覆盖；否则，就错了。如果 terrainProvider不提供防水面罩。
Default Value: true

terrainProvider : TerrainProvider
Scene/Globe.js 429

为地球仪提供曲面几何图形的地形提供商。

readonly terrainProviderChanged : Event
Scene/Globe.js 450

获取当地形提供程序更改时引发的事件

tileCacheSize : Number
Scene/Globe.js 109

地形图块缓存的大小，以平铺数表示。任何额外的 超过此数字的分片将被释放，只要它们不需要渲染 这个框架。较大的数字将消耗更多内存，但显示细节的速度会更快 例如，缩小然后再缩小。
Default Value: 100

tileLoadProgressEvent : Event
Scene/Globe.js 462

获取自上一个呈现帧后，当平铺加载队列的长度发生更改时引发的事件。当加载队列为空时， 当前视图的所有地形和图像都已加载。事件通过新的平铺加载队列长度。

readonly tilesLoaded : Boolean
Scene/Globe.js 346

当tile加载队列为空时返回true，否则返回false。当加载队列为空时， 当前视图的所有地形和图像都已加载。

translucency : GlobeTranslucency
Scene/Globe.js 549

用于控制全局半透明性的属性。

undergroundColor : Color
Scene/Globe.js 498



当摄影机位于地下或地球仪为半透明时，渲染球体背面的颜色， 与基于摄影机距离的球体颜色混合。 要禁用地下着色，请将undergroundColor设置为undefined。
Default Value: Color.BLACK
See:

undergroundColorAlphaByDistance : NearFarScalar
Scene/Globe.js 524



获取或设置用于将Globe#undergroundColor与球体颜色混合的远近距离。 alpha将在NearFarScalar#nearValue和 NearFarScalar#farValue，摄像机距离在上下限范围内 指定的NearFarScalar#near和NearFarScalar#far。 在这些范围之外，alpha保持在最近的边界。如果未定义， 地下颜色不会与地球颜色混合。 当相机位于椭球体上方时，距离从最近的 指向椭球体而不是摄影机的位置。
See:

Methods

destroy()
Scene/Globe.js 1025



销毁此对象持有的WebGL资源。销毁一个对象允许确定性 释放WebGL资源，而不是依赖垃圾回收器销毁此对象。 一旦一个对象被销毁，就不应该使用它；调用除 isDestroyed将导致DeveloperError异常。因此， 如示例所示，将返回值（undefined）分配给对象。
Throws:
Example:
globe = globe && globe.destroy();
See:

getHeight(cartographic) → Number|undefined
Scene/Globe.js 755

在给定的地图上求出曲面的高度。
Name Type Description
cartographic Cartographic 找到高度的地图。
Returns:
如果找不到地图的高度或未定义的高度。

isDestroyed() → Boolean
Scene/Globe.js 1005



如果此对象已销毁，则返回true；否则返回false。 如果此对象已被销毁，则不应使用它；调用除 isDestroyed将导致DeveloperError异常。
Returns:
如果此对象被销毁，则为True；否则为false。
See:

pick(ray, scene, result) → Cartesian3|undefined
Scene/Globe.js 727

查找光线与渲染的球体曲面之间的交点。光线必须在世界坐标中给出。
Name Type Description
ray Ray 要测试相交的光线。
scene Scene 现场。
result Cartesian3 optional 要将结果存储到的对象。
Returns:
如果找不到交叉口，请拨打undefined。
Example:
// find intersection of ray through a pixel and the globe
var ray = viewer.camera.getPickRay(windowCoordinates);
var intersection = globe.pick(ray, scene);