Class: SkyBox

SkyBox

new SkyBox()

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

Name Type Default Description
options.sources Object 可选

六个立方体贴图面中每个面的源URL或影像对象 具体参考下面的示例。
options.show Boolean true 可选

是否显示天空盒。
See:
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'
  }
});

Members

horizontalRotationAngleNumber

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

Default Value:
0

imageUrlString

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

showBoolean

是否显示天空盒。

Default Value:
true

sourcesObject

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

Default Value:
undefined

USpeedNumber

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

Default Value:
0.0

VSpeedNumber

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

Default Value:
0.0

WSpeedNumber

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

Default Value:
0.0

Methods

destroy(){undefined}

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

一旦对象被销毁，就不得再使用；调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。 因此，请按照示例中的方法将返回值（undefined）赋值给对象。

See:
Throws:

该对象已被销毁，即 destroy() 被调用。

Type
DeveloperError
Returns:
Type Description
undefined
Example
skyBox = skyBox && skyBox.destroy();

isDestroyed(){Boolean}

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

如果该对象已被销毁，则不应使用；调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。

See:
Returns:
Type Description
Boolean 如果该对象已被销毁，则为 true；否则为 false

update()

在Viewer 或 Widget 渲染场景时调用，以获取渲染该基元所需的绘制指令。

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

Throws:

  • this.sources 为必填项，且必须具有正 X、负 X、正 Y、负 Y、正 Z 和负 Z 属性。

    Type
    DeveloperError

  • this.sources 属性都必须是同一类型。

    Type
    DeveloperError