Globe - CesiumJS API 文档

new Cesium.Globe(ellipsoid)

The globe rendered in the scene, including its terrain (Globe#terrainProvider) and imagery layers (Globe#imageryLayers). Access the globe using Scene#globe.

Name	Type	Default	Description
`ellipsoid`	Ellipsoid	`Ellipsoid.default`	optional Determines the size and shape of the globe.

Members

atmosphereBrightnessShift : number

亮度变化以适用于大气. 默认为 0.0( 无移位) . -1.0的亮度变化是完全的黑暗,它会让太空展现出来.

Default Value: 0.0

atmosphereHueShift : number

气温变化适用于大气。默认为 0.0( 无移位) . 变化为1.0表示可用色调的完全旋转.

Default Value: 0.0

atmosphereLightIntensity : number

用于计算地面大气颜色的光的强度.

Default Value: 10.0

atmosphereMieAnisotropy : number

介质的异同位素来考虑小米的散射.

有效值在-1.0至1.0之间.

Default Value: 0.9

atmosphereMieCoefficient : Cartesian3

地面大气散射方程中使用的米埃散射系数.

Default Value: Cartesian3(21e-6, 21e-6, 21e-6)

atmosphereMieScaleHeight : number

大气散射方程中用于地面大气的米氏度高度,以米计.

Default Value: 3200.0

atmosphereRayleighCoefficient : Cartesian3

大气散射方程中用于地面大气的雷利散射系数.

Default Value: Cartesian3(5.5e-6, 13.0e-6, 28.4e-6)

atmosphereRayleighScaleHeight : number

用于地面大气大气散射方程的Rayleigh比例高度,以米计.

Default Value: 10000.0

atmosphereSaturationShift : number

饱和度变化适用于大气. 默认为 0.0( 无移位) . 饱和偏移-1.0为单色.

Default Value: 0.0

backFaceCulling : boolean

是否要弯曲反向地形. 当摄像头处于地下或具有透明性时,后脸不会弯曲.

Default Value: true

baseColor : Color

在没有图像时获取或设定地球的颜色.

cartographicLimitRectangle : Rectangle

A property specifying a Rectangle used to limit globe rendering to a cartographic area. 默认地图坐标的最大范围.

Default Value: Rectangle.MAX_VALUE

clippingPlanes : ClippingPlaneCollection

A property specifying a ClippingPlaneCollection used to selectively disable rendering on the outside of each plane.

clippingPolygons : ClippingPolygonCollection

指定 ClippingPolygonCollection 的属性,用于选择性地禁用多边形列表内外的渲染 .

depthTestAgainstTerrain : boolean

如果诸如公告牌、多线、标签等原始物应进行深度测试,则属实或假的,如果这些原始的总是画在顶端除非它们位于地球的对面深度的缺点对地形进行原始的测试是微小的数值噪音或地形水平切换有时可以使一个应该放在表面的原始物消失在它的下面.

Default Value: false

dynamicAtmosphereLighting : boolean

启用对大气和雾的动态照明效果. 这才有效当 NT+0 enableLighting NT+1 为 NT+2 real NT+3 时.

Default Value: true

dynamicAtmosphereLightingFromSun : boolean

动态大气照明是否使用太阳方向而不是场景灯光方向。这只有在 NT 0 enableLighting NT 1 和时才生效 dynamicAtmosphereLighting are true.

Default Value: false

ellipsoid : Ellipsoid

得到一个椭圆形描述这个地球的形状.

enableLighting : boolean

启用以场景的光源点亮地球 .

Default Value: false

fillHighlightColor : Color

用于突出地形填充瓦片的颜色。如果未定义, 填充牌不是重点突出。 α值用于将α与瓷砖混合实际颜色。由于地形填充瓦片并不代表实际地形表面, 在一些应用程序中,可能有必要视而不见地表明它们不被信任.

Default Value: undefined

imageryLayers : ImageryLayerCollection

获得将在此地球渲染的图像层的集合 .

readonly imageryLayersUpdatedEvent : Event

获得一个在图像层被添加,显示,隐藏,移动,或移除时被提升的事件.

lambertDiffuseMultiplier : number

乘以调整地形羊肉照明. 此数乘以 NT 0 czm getLambert Diffuse NT 1 在 NT 2 中的结果. 这只有在 NT 0 enableLighting NT 1 为 NT 2 rect NT 3 时才生效.

Default Value: 0.9

lightingFadeInDistance : number

恢复照明的距离。这才有效当 NT 0 enableLighting NT 1 或 NT 2 显示GroundAtmosphere NT 3 为 NT 4 real NT 5 时.

Default Value: pi * ellipsoid.minimumRadius

lightingFadeOutDistance : number

一切变得闪烁的距离这才有效当 NT 0 enableLighting NT 1 或 NT 2 显示GroundAtmosphere NT 3 为 NT 4 real NT 5 时.

Default Value: 1/2 * pi * ellipsoid.minimumRadius

loadingDescendantLimit : number

获得或设定被认为"太多"的后人加载瓦片的数量. 如果瓷砖装入的后代太多,那瓷砖将在任何瓷砖之前装入并制成它的子孙被装满和制造。这意味着更多的反馈给用户某事以较长的总载荷时间为代价。设为 0 将造成每个相继加载的瓦片级,显著增加装载时间. 设成一个大数字( NT % 0 . 1000) 将最小化装入但倾向于制造的瓷砖数细节在等待很久后立即出现.

Default Value: 20

material : Material|undefined

Gets or sets the material appearance of the Globe. This can be one of several built-in Material objects or a custom material, scripted with Fabric.

maximumScreenSpaceError : number

用于驱动详细级改进的最大屏幕-空间错误. 高级值将提供更好的性能,但视觉质量较低.

Default Value: 2

nightFadeInDistance : number

夜晚的黑暗从地面大气层消失到未亮的地面大气层. 这只有在 NT 0 显示GroundAtmosphere NT 1 , NT 2 enableLighting NT 3 时才生效,而且 dynamicAtmosphereLighting are true.

Default Value: 5/2 * pi * * ellipsoid.minimumRadius

nightFadeOutDistance : number

夜晚的黑暗从地面大气中消失到光亮的地面大气中. 这只有在 NT 0 显示GroundAtmosphere NT 1 , NT 2 enableLighting NT 3 时才生效,而且 dynamicAtmosphereLighting are true.

Default Value: 1/2 * pi * ellipsoid.minimumRadius

oceanNormalMapUrl : string

用于在海洋中渲染波浪的普通地图. 设置此属性只有在配置的地形提供者包含一个水面罩时才有效果.

Default Value: buildModuleUrl('Assets/Textures/waterNormalsSmall.jpg')

preloadAncestors : boolean

获取或设置一个数值,表示是否应该预装制成的瓷砖的祖先. 设置此功能以真正优化缩放体验,并提供更详细的信息新暴露区域在平潭时. 下方是需要加载更多的瓷砖.

Default Value: true

preloadSiblings : boolean

获取或设置一个数值,说明是否应该预装制成的瓷砖的兄弟姐妹. 将此设定为真正导致与制成的瓷砖具有相同父牌的瓷砖被装入, 甚至如果他们被割伤。实现这一点,可能提供更好的经验加载更多瓷砖的成本.

Default Value: false

shadows : ShadowMode

确定地球是投影还是接收光源的阴影。建立全球由于地形再次从光线的角度被渲染,投影可能会影响性能. 目前只有视线内的地形投下阴影. 默认,地球不会投下阴影.

Default Value: -NT=0=- 翻译:

show : boolean

确定是否显示地球表 .

Default Value: true

showGroundAtmosphere : boolean

启用地面大气层,从 NT 0 光线FadeInDistance NT 1 到 NT 2 光线FadeOutDistance NT 3 的距离查看时绘制于地球上空.

Default Value: true when using the WGS84 ellipsoid, false otherwise

showSkirts : boolean

是否显示地形裙子。地表裙是从一块瓷砖边缘向下延伸的几何结构,用来隐藏邻近的瓷砖之间的缝隙. 当相机处于地下或允许透明时,短裙总是被隐藏.

Default Value: true

showWaterEffect : boolean

如果在全球地区显示动画波效应,则属实被水覆盖;否则,是虚假的。如果 -NT###0 铁线 Provider NT###1 不提供水面罩.

Default Value: true

terrainProvider : TerrainProvider

提供地球表面几何的地形提供者.

readonly terrainProviderChanged : Event

获得一个在地形提供者被改变时提升的事件

tileCacheSize : number

地形瓷砖缓存的大小,以若干瓷砖表示. 任何额外的超过这个数字的瓷砖将被释放,只要它们不需要用于渲染这个框。更多的数字会消耗更多的内存,但会更快地显示细节比如说,缩放,然后返回.

Default Value: 100

tileLoadProgressEvent : Event

获得自上一个渲染框架以来瓷砖加载队列长度变化时提升的事件. 当负载队列为空时, 当前视图的所有地形和图像已装入。此事件会通过砖块加载队列的新长度 .

readonly tilesLoaded : boolean

返回 NT 0 true NT 1 当瓷砖加载队列为空时, NT 2 false NT 3 否则. 当负载队列为空时, 当前视图的所有地形和图像已被装入 .

translucency : GlobeTranslucency

控制地球透明化的属性 .

undergroundColor : Color

当摄像头在地下或地球半透明时使地球后方的颜色, 根据相机的距离与地球的颜色混合.

To disable underground coloring, set undergroundColor to undefined.

Default Value: Color.BLACK

See:

Globe#undergroundColorAlphaByDistance

undergroundColorAlphaByDistance : NearFarScalar

获取或设置近距离和远距离将 Globe#undergroundColor 与地球颜色混合. The alpha will interpolate between the NearFarScalar#nearValue and NearFarScalar#farValue while the camera distance falls within the lower and upper bounds of the specified NearFarScalar#near and NearFarScalar#far. 在这些区域之外,阿尔法遗迹被夹在最近的束缚处。如果未定义, 地下颜色不会与地球颜色混合.

当相机在椭圆上方时,从最近的距离计算点在椭圆形上而不是相机的位置.

See:

Globe#undergroundColor

vertexShadowDarkness : number

确定顶点阴影的黑暗. 这只有在 NT 0 enableLighting NT 1 为 NT 2 rect NT 3 时才生效.

Default Value: 0.3

Methods

destroy()

Destroys the WebGL resources held by this object. Destroying an object allows for deterministic 释放 WebGL 资源,而不是依赖垃圾收集器来摧毁此对象.

Once an object is destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception. Therefore, assign the return value (undefined) to the object as done in the example.

Throws:

DeveloperError : This object was destroyed, i.e., destroy() was called.

Example:

globe = globe && globe.destroy();

See:

Globe#isDestroyed

getHeight(cartographic) → number|undefined

在给定的地图上获取表面高度 .

Name	Type	Description
`cartographic`	Cartographic	寻找高度的地图.

Returns:

无法找到地图的高度或未定义 .

isDestroyed() → boolean

如果此对象被销毁, 返回真实; 否则, 错误 .

If this object was destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception.

Returns:

如果此天体被销毁, 则属真; 否则, 属假 .

See:

Globe#destroy

pick(ray, scene, result) → Cartesian3|undefined

找到射线与地球表面的交叉点射线必须在世界坐标中给出.

Name	Type	Description
`ray`	Ray	用来测试交叉点的射线.
`scene`	Scene	The scene.
`result`	Cartesian3	optional 存储结果的对象 .

Returns:

如果没有找到,则交叉点或 NT 0 未定义 NT 1 .

Example:

// find intersection of ray through a pixel and the globe
const ray = viewer.camera.getPickRay(windowCoordinates);
const intersection = globe.pick(ray, scene);