场景
一个高性能的2D/3D场景图库,用于构建交互式视觉编辑器. 它结合了HTML5 Canvas和Tree.js,可以实现设施可视化,由数据驱动的动画,以及从单一组件模型产生的实时监测仪表板.
特征
- 高性能 Canvas 二维渲染
- 三.js基于三维渲染(WebGL)
- 基于构成部分的架构
- Gizmo 编辑系统( 移动 / 旋转 / 缩放)
- 材料3D预置系统(金属、玻璃、塑料、木材、陶瓷、橡胶)
- 无缝2D QQ 3D 属性绑定
- GLTF/GLB 模型装入每个节点的控制
- 无害环境管理和UMD建设
- 类型脚本严格模式
安装
npm install @hatiolab/things-scene
使用量
无害环境管理(建议)
import { Scene, Component } from '@hatiolab/things-scene'
// create and render a scene
UMD 图像
<script src="node_modules/@hatiolab/things-scene/things-scene-min.js"></script>
<script>
const { Scene, Component } = window['things-scene']
</script>
三维特性( v10)
启用 三维模式
设定 threed: true 在模型层上启用 三维模式。 单一组成部分模式
制取到2D和3D,使用活模式切换.
材质3D API
通过组件控制三维材料 material3d 属性 :
component.set('material3d', {
preset: 'glass', // default, metal, glass, plastic, wood, ceramic, rubber
metalness: 0.5, // 0–1
roughness: 0.3, // 0–1
opacity: 0.3, // 0–1 (preset default or explicit)
envMapIntensity: 1.5, // 0–3
side: 'double', // double, front, back
castShadow: true,
receiveShadow: false,
})
3D 组件类型
球体 立方体 圆柱体 班纳相机 墙体 GLTF Object, Light, Sprite.
GLTF 模型
component.set('src', '/models/building.glb')
component.set('nodes', {
Wall: { color: '#ff0000', opacity: 0.5 },
Door: { visible: false },
})
构建
| 格式 | 文件 | 目标 |
|---|---|---|
| 无害环境管理 | things-scene.mjs | 现代浏览器 |
| UMD 图像 | things-scene-min.js | 任何环境 |
| 节点 | things-scene-transfer.mjs | 无头/安全部门改革模拟 |
npm run build # types + rollup (production)
npm test # 2460+ tests (mocha)
npm run type-check # tsc --noEmit
发展
见 发展.md 为开发设置.
迁移 v9 – v10
中断更改
strict: true- 自定义组件必须满足strictPropertyInitialization等 (中文(简体) ).- 硬化评估沙盒 -
window编号 :document编号 :globalThis访问被屏蔽 (单位:千美元)scene, (中文(简体) ),setTimeout, (中文(简体) ),Math,并保留类似内容). innerHTML→textContent,通过 DOMPurify 进行安全 HTML 渲染.- 这个
stategetter 现在是一个代理服务器(行为兼容: get / 有 / 拥有 Keys / 分布所有支持) . bounds返回值为Object.freezed) 变异前带有散射的复制件.
见 变动情况 完整名单.
许可证
这个项目是根据专利许可证发放的. 许可条件 : http://things-scene.hatiolab.com/EULA/ (英语)