Files
ViewDesignEngine/docs/guides/module-manual.md
T
茂之钳 486a0fe011
CI / Build & Test (push) Failing after 35s
CI / Release Build (push) Failing after 33s
Build & Test / build-and-test (push) Has been cancelled
Build & Test / python-bindings (push) Has been cancelled
docs: reorganize documentation — developer-friendly structure
New structure:
- docs/index.md — main navigation
- docs/getting-started.md — 5-minute quick start
- docs/guides/module-manual.md — all 11 modules with file listing
- docs/guides/api-usage.md — API reference with code examples
- docs/guides/ — architecture, building, testing, contributing
- docs/reference/ — competitive analysis, gap analysis, versioning
- docs/api/ — Doxygen generated HTML
- docs/archive/ — historical development plans

Old development plans archived. Clean 4-directory layout.
2026-07-27 13:32:20 +08:00

126 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 模块功能说明书
> 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` | 高级NURBStrim/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集成 |