Globe

new Cesium.Globe ( ellipsoid )

场景中渲染的地球,包括其地形( Globe#terrainProvider )和图像图层( Globe#imageryLayers )。使用 Scene#globe 访问地球。
Name Type Default Description
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 确定尺寸和形状地球。

Members

atmosphereBrightnessShift : Number

亮度变化适用于大气。默认为0.0(无移位)。-1.0的亮度偏移是完全黑暗,这将使空间显示出来。
Default Value: 0.0

atmosphereHueShift : Number

色调变化适用于大气。默认为0.0(无移位)。色相偏移1.0表示可用色相完全旋转。
Default Value: 0.0

atmosphereSaturationShift : Number

饱和度偏移将应用于大气。默认为0.0(无移位)。-1.0的饱和度偏移是单色的。
Default Value: 0.0
在没有可用图像时获取或设置地球的颜色。
指定 ClippingPlaneCollection 的属性,用于有选择地禁用每个平面外部的渲染。

depthTestAgainstTerrain : Boolean

如果应对广告牌,折线,标签等图元进行深度测试,则为真相对于地形表面;如果应始终在顶部绘制此类图元,则为false除非它们位于地球的另一侧。深度的缺点针对图元测试图元是轻微的数字噪声或图面细节水平切换有时会使应该在表面上的图元消失在其下方。
Default Value: false
获取描述此地球形状的椭圆体。

enableLighting : Boolean

启用以太阳为光源的地球。
Default Value: false

fillHighlightColor : Color

用于突出显示地形填充图块的颜色。如果未定义,则填充图块不突出显示。 Alpha值用于与图块的Alpha混合实际颜色。由于地形填充图块不代表实际的地形表面,在某些应用程序中直观地表明它们不受信任可能会很有用。
Default Value: undefined
获取将在此地球上渲染的图像图层的集合。

readonly imageryLayersUpdatedEvent : Event

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

lightingFadeInDistance : Number

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

lightingFadeOutDistance : Number

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

loadingDescendantLimit : Number

获取或设置被视为'太多'的加载后代切片的数量。如果某个图块的加载后代过多,则该图块将在任何它的后代将被加载和渲染。这意味着更多的反馈给用户以较长的整体加载时间为代价进行操作。设置为0将导致每个要连续加载的图块级别,显着增加了加载时间。设置大数量(例如1000)将最大限度地减少已加载但易于生成的图块数量经过漫长的等待,细节立即全部出现。
Default Value: 20
获取或设置地球仪的材质外观。这可以是以下几种内置的 Material 对象或使用以下脚本编写的自定义材料之一: 织物

maximumScreenSpaceError : Number

用于驱动细节级别细化的最大屏幕空间错误。更高值将提供更好的性能,但降低视觉质量。
Default Value: 2

nightFadeInDistance : Number

夜晚的黑暗从地面大气逐渐消失到昏暗的地面大气的距离。仅当 showGroundAtmosphere enableLighting true 时才生效。
Default Value: 50000000.0

nightFadeOutDistance : Number

夜晚的黑暗从地面大气逐渐消失到明亮的地面大气的距离。仅当 showGroundAtmosphere enableLighting true 时才生效。
Default Value: 10000000.0

oceanNormalMapUrl : String

用于在海洋中渲染波浪的法线贴图。设置此属性将仅在配置的地形提供程序包括水罩的情况下才起作用。
Default Value: buildModuleUrl('Assets/Textures/waterNormalsSmall.jpg')

preloadAncestors : Boolean

获取或设置一个值,该值指示是否应预加载渲染图块的祖先。将此设置为true可优化缩小体验,并在平移时新暴露的区域。缺点是需要加载更多的图块。
Default Value: true

preloadSiblings : Boolean

获取或设置一个值,该值指示是否应预加载渲染图块的同级。将此设置为true会导致加载与渲染图块具有相同父级图块的图块,即使如果他们被淘汰。将此设置为true可能会提供更好的平移体验加载更多瓷砖的成本。
Default Value: false
确定地球是投射还是接收来自每个光源的阴影。设置地球投射阴影可能会影响性能,因为从灯光的角度重新渲染了地形。当前,只有可见的地形会投射阴影。默认情况下,地球仪不会投射阴影。
Default Value: ShadowMode.RECEIVE_ONLY

show : Boolean

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

showGroundAtmosphere : Boolean

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

showWaterEffect : Boolean

如果应在全球范围内显示动画波浪效果,则为true被水覆盖;否则为假。如果 terrainProvider 不提供水面罩。
Default Value: true
地形提供程序为该地球仪提供了表面几何形状。

readonly terrainProviderChanged : Event

获取更改地形提供者时引发的事件

tileCacheSize : Number

地形图块缓存的大小,表示为图块数。任何其他只要不需要渲染,就会释放超出此数目的图块这个框架。较大的数字将占用更多的内存,但显示细节更快例如,当缩小然后再放大时。
Default Value: 100

tileLoadProgressEvent : Event

获取自上一个渲染帧以来切片加载队列的长度发生更改时引发的事件。当加载队列为空时,当前视图的所有地形和图像均已加载。该事件将传递图块加载队列的新长度。

readonly tilesLoaded : Boolean

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

Methods

销毁此对象拥有的WebGL资源。销毁对象可以确定性释放WebGL资源,而不是依靠垃圾回收器来破坏此对象。

一旦物体被破坏,就不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。因此,如示例中所述,将返回值( undefined )分配给对象。
Throws:
Example:
globe = globe && globe.destroy();
See:

getHeight (cartographic) Number|undefined

获取给定制图上的表面高度。
Name Type Description
cartographic Cartographic 要查找高度的制图。
Returns:
制图的高度,如果找不到则未定义。

isDestroyed () Boolean

如果此对象已销毁,则返回true;否则返回false。否则为假。

如果该对象被破坏,则不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。
Returns:
如果该对象被破坏,则为true;否则为假。
See:

pick (ray, scene, result ) Cartesian3 |undefined

找到射线与渲染的地球表面之间的交点。射线必须以世界坐标给出。
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);