45 lines
1.5 KiB
Markdown
45 lines
1.5 KiB
Markdown
---
|
||
outline: [2, 3]
|
||
---
|
||
|
||
# 文档说明
|
||
|
||
Deep Engine 是一个**基于 Three.js WebGPU 进行封装的三维引擎库**。本文档站用于说明该库的定位、能力范围以及文档阅读方式。
|
||
|
||
## 库定位
|
||
|
||
该项目并不是对 Three.js 的简单示例集合，而是在 Three.js WebGPU 能力基础上进行二次封装，形成一套更适合业务项目接入的 SDK。
|
||
|
||
它主要面向以下场景：
|
||
|
||
- 三维场景浏览与交互
|
||
- 行业模型加载与展示
|
||
- 参数化构件生成
|
||
- 剖切、选择、标注与面板管理
|
||
- 点云、体积数据与特效表现
|
||
|
||
## 文档内容
|
||
|
||
当前文档主要分为以下几部分：
|
||
|
||
- `首页`：说明库的整体定位与核心能力
|
||
- `API`：按源码模块整理的接口文档
|
||
- `API 示例说明`：说明文档的组织方式与阅读建议
|
||
|
||
## 阅读建议
|
||
|
||
如果你是第一次接触这个库，建议按下面顺序阅读：
|
||
|
||
1. 先阅读首页，了解该库是基于 Three.js WebGPU 的封装库。
|
||
2. 再阅读 `packages/docs/api` 下的 API 文档，熟悉 `Viewer`、`Tool`、`Parametric`、`Effect` 等模块。
|
||
3. 最后结合 `packages/demo/src` 中的示例场景，对照查看具体调用方式。
|
||
|
||
## 与 Demo 的关系
|
||
|
||
文档中的很多示例都来自 `packages/demo/src`。
|
||
也就是说，文档并不是脱离项目的独立说明，而是与 Demo 保持对应关系，方便直接从真实业务代码理解 API 的使用方式。
|
||
|
||
## 说明
|
||
|
||
后续如果 SDK 能力继续扩展，这里的说明页也应同步更新，确保文档与源码、Demo 保持一致。
|