Globe

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

场景中渲染的地球，包括其地形（ Globe＃terrainProvider ）和图像图层（ Globe＃imageryLayers ）。使用 Scene＃globe 访问地球。
Name Type Default Description
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 确定尺寸和形状地球。
翻译by:http://cesium.xin

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

如果应对广告牌，折线，标签等图元进行深度测试，则为真抵靠地形表面；如果应始终将此类图元绘制在顶部，则为false除非它们位于地球的另一侧。深度的缺点针对图元测试图元是轻微的数值噪声或图面细节级别切换有时会使应该在表面上的图元消失在其下方。
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

当图块加载队列为空时，返回 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 可选 将结果存储到的对象。
Returns:
交点或 未定义 如果没有找到。
Example: 
// find intersection of ray through a pixel and the globe
var ray = viewer.camera.getPickRay(windowCoordinates);
var intersection = globe.pick(ray, scene);