Skip to content

SkyBox

NIVIOBIM天空盒功能模块,提供3D场景的天空盒背景功能。支持立方体贴图天空盒,为3D场景提供环境背景和雾效。

类定义

javascript
class SkyBox extends Plugin

构造函数

constructor(viewer3D, options)

创建天空盒插件实例,初始化天空盒插件,设置场景管理器和立方体贴图加载器。

参数:

  • viewer3D {Viewer3D} - Viewer3D实例,提供场景管理器访问
  • options {Object} - 插件配置选项

示例:

javascript
// 创建天空盒插件
const skyBox = new SkyBox(viewer3D, {
    name: 'SkyBox'
});

属性

enabled

天空盒功能是否启用,控制天空盒背景和雾效的显示。

类型: {boolean}
默认值: false

示例:

javascript
// 启用天空盒
skyBox.enabled = true;

// 禁用天空盒
skyBox.enabled = false;

// 检查天空盒是否启用
if (skyBox.enabled) {
    console.log('天空盒已启用');
}

方法

setSkyBoxUrls(urls)

设置天空盒的6个图片地址,设置立方体贴图天空盒的6张图片地址。

参数:

  • urls {Array<string>} - 6张图片的URL地址数组,按照Three.js的约定顺序:[px, nx, py, ny, pz, nz]

示例:

javascript
// 设置天空盒图片
skyBox.setSkyBoxUrls([
    'right.jpg',   // px - 右面
    'left.jpg',    // nx - 左面
    'top.jpg',     // py - 上面
    'bottom.jpg',  // ny - 下面
    'front.jpg',   // pz - 前面
    'back.jpg'     // nz - 后面
]);

dispose()

销毁天空盒插件,清理插件资源,移除天空盒背景和雾效。

示例:

javascript
// 销毁天空盒插件
skyBox.dispose();

相关链接

文档内容为北京逆维悦动科技有限公司版权所有,禁止未授权转载