SkyBox

new SuperMap3D.SkyBox(options)

场景周围的天空盒。

仅在3D场景中使用变为2D场景,天空盒会淡出,天空盒大小不得超过Scene#maximumCubeMapSize

Name Type Description
options Object 具有以下属性的对象:
Name Type Default Description
sources Object optional 六个立方体贴图面中每个面的源URL或影像对象 具体参考下面的示例。
show Boolean true optional 是否显示。
Example:
scene.skyBox = new SuperMap3D.SkyBox({
  sources : {
    positiveX : 'skybox_px.png',
    negativeX : 'skybox_nx.png',
    positiveY : 'skybox_py.png',
    negativeY : 'skybox_ny.png',
    positiveZ : 'skybox_pz.png',
    negativeZ : 'skybox_nz.png'
  }
});
See:

Members

horizontalRotationAngle : Number

获取或者设置天空盒子独立水平旋转角度(取值为弧度)。
Default Value: 0

imageUrl : String

使用一张JPG或HDR格式图片实现天空盒效果。

show : Boolean

是否显示天空盒。
Default Value: true

sources : Object

用于创建立方体贴图的来源:具有正 X、负 X、正 Y、负 Y、正 Z 和负 Z 属性的对象。
Default Value: undefined

USpeed : Number

获取或者设置天空盒子绕x轴运动的动画速度。设置为1时表示0.01弧度每秒,下同。
Default Value: 0.0

VSpeed : Number

获取或者设置天空盒子绕y轴运动的动画速度。
Default Value: 0.0

WSpeed : Number

获取或者设置天空盒子绕z轴运动的动画速度。
Default Value: 0.0

Methods

destroy()undefined

销毁该对象持有的 WebGL 资源。销毁对象可以确定性地 释放 WebGL 资源,而不是依赖垃圾回收器来销毁该对象。

一旦对象被销毁,就不得再使用;调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。 因此,请按照示例中的方法将返回值(undefined)赋值给对象。
Returns:
Throws:
Example:
skyBox = skyBox && skyBox.destroy();
See:

isDestroyed()Boolean

如果该对象已被销毁,则返回 true;否则返回 false。

如果该对象已被销毁,则不应使用;调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。
Returns:
如果该对象已被销毁,则为 true;否则为 false
See:

update()

ViewerWidget 渲染场景时调用,以获取渲染该基元所需的绘制指令。

请勿直接调用此函数。记录此函数只是为了 列出场景渲染时可能传播的异常:

Throws:
  • DeveloperError : this.sources 为必填项,且必须具有正 X、负 X、正 Y、负 Y、正 Z 和负 Z 属性。
  • DeveloperError : this.sources 属性都必须是同一类型。