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();