ViewDesignEngine
136 lines
4.3 KiB
Markdown
136 lines
4.3 KiB
Markdown
# 模块划分
|
||
|
||
## 目录
|
||
|
||
1. [M01：基础设施层（foundation）](#m01基础设施层foundation)
|
||
2. [M02：几何核心层（core）](#m02几何核心层core)
|
||
3. [M03：曲线曲面层（curves）](#m03曲线曲面层curves)
|
||
4. [M04：网格处理层（mesh）](#m04网格处理层mesh)
|
||
5. [M05：空间索引层（spatial）](#m05空间索引层spatial)
|
||
6. [M06：布尔运算层（boolean）](#m06布尔运算层boolean)
|
||
7. [M07：碰撞检测层（collision）](#m07碰撞检测层collision)
|
||
8. [构建目标总览](#8-构建目标总览)
|
||
|
||
---
|
||
|
||
## M01：基础设施层（foundation）
|
||
|
||
**路径**：`src/foundation/`
|
||
**命名空间**：`vde::foundation`
|
||
|
||
| 组件 | 文件 | 说明 |
|
||
|------|------|------|
|
||
| 数学封装 | `math_types.h/cpp` | Eigen 二次封装，统一向量/矩阵接口 |
|
||
| 精确谓词 | `exact_predicates.h/cpp` | Shewchuk 自适应精度谓词 |
|
||
| 公差系统 | `tolerance.h/cpp` | 全局/局部公差管理 |
|
||
| 内存池 | `memory_pool.h/cpp` | 高性能内存分配器 |
|
||
| I/O | `io_obj.h/cpp`, `io_stl.h/cpp` | OBJ/STL 文件读写 |
|
||
| 错误码 | `error_codes.h` | 统一错误码枚举 |
|
||
|
||
**公开头文件**：`include/vde/foundation/*.h`
|
||
|
||
---
|
||
|
||
## M02：几何核心层（core）
|
||
|
||
**路径**：`src/core/`
|
||
**命名空间**：`vde::core`
|
||
|
||
| 组件 | 文件 | 说明 |
|
||
|------|------|------|
|
||
| 基本类型 | `point.h`, `line.h`, `plane.h` | 点/线/面的类型别名与便捷函数 |
|
||
| 基本图形 | `triangle.h`, `polygon.h` | 三角形与多边形 |
|
||
| 包围盒 | `aabb.h` | 轴对齐包围盒 |
|
||
| 变换 | `transform.h` | 平移/旋转/缩放的便捷函数 |
|
||
| 距离计算 | `distance.h` | 各类几何距离计算 |
|
||
| 凸包 | `convex_hull.h` | 2D 与 3D 凸包算法 |
|
||
|
||
---
|
||
|
||
## M03：曲线曲面层（curves）
|
||
|
||
**路径**：`src/curves/`
|
||
**命名空间**：`vde::curves`
|
||
|
||
| 组件 | 文件 | 说明 |
|
||
|------|------|------|
|
||
| Bezier 曲线 | `bezier_curve.h/cpp` | 任意阶 Bezier 曲线 |
|
||
| B-Spline 曲线 | `bspline_curve.h/cpp` | B-Spline 曲线 |
|
||
| NURBS 曲线 | `nurbs_curve.h/cpp` | NURBS 曲线 |
|
||
| Bezier 曲面 | `bezier_surface.h/cpp` | 张量积 Bezier 曲面 |
|
||
| B-Spline 曲面 | `bspline_surface.h/cpp` | B-Spline 曲面 |
|
||
| 离散化 | `tessellation.h/cpp` | 曲线/曲面三角网格化 |
|
||
|
||
---
|
||
|
||
## M04：网格处理层（mesh）
|
||
|
||
**路径**：`src/mesh/`
|
||
**命名空间**：`vde::mesh`
|
||
|
||
| 组件 | 文件 | 说明 |
|
||
|------|------|------|
|
||
| 半边网格 | `halfedge_mesh.h/cpp` | 半边数据结构与拓扑查询 |
|
||
| Delaunay 剖分 | `delaunay_2d.h/cpp` | 2D Bowyer-Watson 算法 |
|
||
| 网格简化 | `mesh_simplify.h/cpp` | QEM 算法 |
|
||
| 网格平滑 | `mesh_smooth.h/cpp` | Laplacian / Taubin 平滑 |
|
||
| 网格布尔 | `mesh_boolean.h/cpp` | 3D 网格布尔运算 |
|
||
| 质量评估 | `mesh_quality.h/cpp` | 网格质量指标 |
|
||
| 网格修复 | `mesh_repair.h/cpp` | 孔洞填充、非流形修复 |
|
||
|
||
---
|
||
|
||
## M05：空间索引层（spatial）
|
||
|
||
**路径**：`src/spatial/`
|
||
**命名空间**：`vde::spatial`
|
||
|
||
| 组件 | 文件 | 说明 |
|
||
|------|------|------|
|
||
| 索引接口 | `spatial_index.h` | 空间索引抽象接口（虚基类） |
|
||
| BVH | `bvh.h/cpp` | 包围体层次结构 |
|
||
| 八叉树 | `octree.h/cpp` | 八叉树空间划分 |
|
||
| KD-Tree | `kd_tree.h/cpp` | K 维树 |
|
||
| R-Tree | `r_tree.h/cpp` | R 树 |
|
||
|
||
---
|
||
|
||
## M06：布尔运算层（boolean）
|
||
|
||
**路径**：`src/boolean/`
|
||
**命名空间**：`vde::boolean`
|
||
|
||
| 组件 | 文件 | 说明 |
|
||
|------|------|------|
|
||
| 2D 布尔 | `boolean_2d.h/cpp` | 多边形布尔运算 |
|
||
| 网格布尔 | `boolean_mesh.h/cpp` | 三角网格布尔运算 |
|
||
|
||
---
|
||
|
||
## M07：碰撞检测层（collision）
|
||
|
||
**路径**：`src/collision/`
|
||
**命名空间**：`vde::collision`
|
||
|
||
| 组件 | 文件 | 说明 |
|
||
|------|------|------|
|
||
| GJK | `gjk.h/cpp` | GJK 算法（凸体碰撞检测） |
|
||
| SAT | `sat.h/cpp` | 分离轴定理（多面体） |
|
||
| 射线相交 | `ray_intersect.h/cpp` | 射线-三角形等相交测试 |
|
||
| 三角形相交 | `tri_intersect.h/cpp` | 三角形-三角形 Möller 算法 |
|
||
|
||
---
|
||
|
||
## 8. 构建目标总览
|
||
|
||
| 目标 | 类型 | 依赖 |
|
||
|------|------|------|
|
||
| `vde_foundation` | 静态库 | Eigen3 |
|
||
| `vde_core` | 静态库 | vde_foundation |
|
||
| `vde_curves` | 静态库 | vde_core |
|
||
| `vde_mesh` | 静态库 | vde_core |
|
||
| `vde_spatial` | 静态库 | vde_core |
|
||
| `vde_boolean` | 静态库 | vde_mesh, vde_spatial |
|
||
| `vde_collision` | 静态库 | vde_core, vde_spatial |
|
||
| `vde` | 聚合库 | 以上全部 |
|