# 模块功能说明书

> ViewDesignEngine v1.0.0-beta.1 · 11 模块

## foundation — 基础设施 + 格式 IO

| 文件 | 功能 |
|------|------|
| `tolerance.h/cpp` | 容差系统（全局/局部/PerFace/ToleranceChain/自适应） |
| `exact_predicates.h/cpp` | GMP精确谓词（orient2d/3d, in_sphere, point_in_polygon/polyhedron） |
| `io_step.h/cpp` | STEP AP203/214/242 导入导出 |
| `io_iges.h/cpp` | IGES 5.3 导入导出 |
| `io_obj/io_stl/io_ply.h/cpp` | OBJ/STL/PLY 网格格式 |
| `io_gltf.h/cpp` | glTF 2.0 / GLB 导出 |
| `io_3mf.h/cpp` | 3MF 3D打印格式 |
| `industrial_formats.h/cpp` | Parasolid XT/SAT/JT/IFC/PDF3D |

## core — 几何核心 + CAM + 性能

| 文件 | 功能 |
|------|------|
| `polygon.h/cpp` | 多边形操作、三角剖分、凸包、简化 |
| `distance.h/cpp` | 点/线/面/体距离计算 |
| `convex_hull.h/cpp` | 2D/3D 凸包 |
| `icp.h/cpp` | 迭代最近点配准 |
| `cam_toolpath.h/cpp` | 基础CAM刀路（轮廓/型腔） |
| `cam_strategies.h/cpp` | 高级CAM（粗/精/钻+刀库+8后处理） |
| `cam_5axis.h/cpp` | 5轴加工（侧刃/3+2/机床运动学） |
| `cam_advanced.h/cpp` | 自适应/摆线/残料/清根/HSM |
| `cam_optimization.h/cpp` | 切屑减薄/恒接触/刀具寿命/进给优化 |
| `simd_vector.h` | SIMD向量（SSE/AVX/NEON自适应） |
| `concurrent_data.h/cpp` | 无锁数据结构（Queue/Stack/HashMap） |
| `transaction.h/cpp` | 事务/Command/UndoManager |
| `performance_tuning.h/cpp` | NUMA/缓存对齐/内存池集成 |
| `topology_compression.h/cpp` | B-Rep拓扑压缩/Edgebreaker |

## curves — 曲线曲面

| 文件 | 功能 |
|------|------|
| `nurbs_curve.h/cpp` | NURBS曲线（求值/导数/节点操作） |
| `nurbs_surface.h/cpp` | NURBS曲面（ruled/revolve/tessellate） |
| `nurbs_operations.h/cpp` | 高级NURBS（trim/blend/offset/extrude） |
| `surface_continuity.h/cpp` | G0-G3连续性分析 |
| `surface_analysis.h/cpp` | 曲率图/斑马纹/高光线/反射线/等照度/拐点线/棋盘格 |
| `surface_extension.h/cpp` | 曲面延伸/N边填充/过渡 |
| `generative_surfaces.h/cpp` | Sweep(3模式)/Loft/Net Surface |
| `surface_editing.h/cpp` | Match Surface(G0-G3)/曲面编辑 |
| `control_point_edit.h/cpp` | 控制点编辑 |
| `curve_tools.h/cpp` | 投影/偏移/连接/螺旋线/等参线 |
| `class_a_surfacing.h/cpp` | A级曲面（G3过渡/能量最小化/曲率优化） |
| `advanced_intersection.h/cpp` | 鲁棒SSI（三阶段）/自交检测 |
| `surface_intersection.h/cpp` | 曲面-曲面/曲线-曲面求交 |
| `iga_prep.h/cpp` | IGA分析准备（节点插入/升阶/Bezier提取） |

## mesh — 网格处理

| 文件 | 功能 |
|------|------|
| `halfedge_mesh.h/cpp` | 半边数据结构 |
| `delaunay_2d.h/cpp` | 2D Delaunay三角剖分 |
| `delaunay_3d.h/cpp` | 3D Delaunay四面体剖分 |
| `mesh_simplify.h/cpp` | QEM网格简化 |
| `mesh_smooth.h/cpp` | Laplacian/Taubin/HC/Bilateral平滑 |
| `mesh_boolean.h/cpp` | 网格布尔运算 |
| `mesh_quality.h/cpp` | 网格质量评估 |
| `marching_cubes.h/cpp` | Marching Cubes等值面提取 |
| `mesh_lod.h/cpp` | LOD网格生成 |
| `fea_mesh.h/cpp` | FEA网格（四面体/边界层/六面体） |
| `reverse_engineering.h/cpp` | 逆向工程（点云→网格→NURBS） |
| `point_cloud.h/cpp` | 点云处理（降采样/法线估计/滤波） |
| `visualization_quality.h/cpp` | AO/边高亮/法线可视化 |

## spatial + boolean + collision — 空间索引与运算

| 文件 | 功能 |
|------|------|
| `bvh.h/cpp` | BVH (SAH构建) |
| `octree.h/cpp` | 八叉树 |
| `kd_tree.h/cpp` | KD-Tree (kNN/射线) |
| `r_tree.h/cpp` | R-Tree (STR bulk-loading) |
| `boolean_2d.h/cpp` | 2D布尔（Sutherland-Hodgman） |
| `boolean_mesh.h/cpp` | 3D网格布尔（并/交/差/对称差） |
| `gjk.h/cpp` | GJK/EPA碰撞检测 |
| `ray_intersect.h/cpp` | Möller-Trumbore射线-三角形 |

## brep — B-Rep 核心

| 文件 | 功能 |
|------|------|
| `brep.h/cpp` | B-Rep数据结构（V/E/L/F/S/B + TrimmedSurface） |
| `modeling.h/cpp` | 高层建模（make_box/cylinder/sphere/extrude等） |
| `brep_boolean.h/cpp` | SSI布尔运算 |
| `brep_heal.h/cpp` | 拓扑修复（gaps/slivers/orientation/topology） |
| `brep_validate.h/cpp` | B-Rep验证 |
| `tolerant_modeling.h/cpp` | 容错建模 |
| `direct_modeling.h/cpp` | 直接建模（push_pull/tweak/move/replace/offset） |
| `ffd_deformation.h/cpp` | FFD自由变形 |
| `sheet_metal.h/cpp` | 钣金（展开/法兰/K-factor） |
| `advanced_blend.h/cpp` | 高级过渡（变半径/多面/滚动球） |
| `feature_recognition.h/cpp` | 特征识别（孔/槽/倒圆/凸台） |
| `defeature.h/cpp` | 去特征化 |
| `gdt.h/cpp` | GD&T 14种符号 |
| `auto_dimensioning.h/cpp` | 自动标注 |
| `pmi_mbd.h/cpp` | PMI/MBD 3D标注 |
| `drawing_standards.h/cpp` | ISO/ANSI/JIS制图标准 |
| `assembly.h/cpp` | 装配体 |
| `constraint_solver.h/cpp` | 3D约束求解（Newton-Raphson） |
| `interference_check.h/cpp` | 干涉检查 |
| `motion_simulation.h/cpp` | 运动仿真 |
| `explode_view.h/cpp` | 爆炸视图 |
| `assembly_lod.h/cpp` | 大装配LOD |
| `assembly_patterns.h/cpp` | 装配阵列 |
| `quality_feedback.h/cpp` | 设计规则检查/可制造性/成本/质量评分 |
| `euler_op.h/cpp` | 欧拉操作（6原语） |

## sdf — 隐式建模

| 文件 | 功能 |
|------|------|
| `sdf_primitives.h/cpp` | 15+隐式图元 |
| `sdf_tree.h/cpp` | CSG树操作 |
| `sdf_to_mesh.h/cpp` | SDF→Mesh转换 |
| `sdf_optimize.h/cpp` | 梯度优化 |
| `sdf_torch.h/cpp` | Torch集成 |