API 参考
Engine 3.0 使用三个公共入口:
| 入口 | 职责 |
|---|---|
@tripo3d/engine | Engine、ECS、Event、Pipeline、Pointer |
@tripo3d/engine/history | standalone History 与 dispose adapter |
@tripo3d/engine/vue | Canvas 与 Vue markRaw Plugin |
根入口工厂
| 工厂 | 说明 |
|---|---|
| createEngine() | 创建唯一 Engine 组合根 |
| createComponent() | 创建 Entity-local setup Component Definition |
| createSystem() | 创建 Engine-global System Definition |
| createScript() | 创建 Entity-local Script Definition |
| createEvent() | 创建 opaque typed Event token |
| createPass() | 创建 after-render 或 after-output Pipeline contribution |
| disposeObject3D() | 释放 Object3D 子树的标准 Three.js 资源,并支持 shared 保护与 force |
根入口不导出 Camera、Scene、Renderer、Object3D、Raycaster 或原生 Pass wrapper。多 View 通过 engine.pipeline.addView(),Entity 层级通过 Entity facade。
History 子入口
| 工厂 | 说明 |
|---|---|
| createHistory() | 创建异步 undo/redo 栈 |
createHistoryPlugin(history) | Engine dispose 时清空 borrowed History |
Vue 子入口
| 导出 | 说明 |
|---|---|
| Canvas | 自动插入 Canvas、start/stop/dispose |
| createPluginVue() | markRaw Engine 初始公共 identity |
自动生成声明
根入口完整 TypeScript API 由当前源码生成,是 Core、ECS、Pipeline 与 Pointer 字段签名的权威参考。History 与 Vue 子入口使用上方手写参考页;指南负责解释所有权、生命周期与场景。