5638568dc7d7242a103c799f28654fe4cb19b5fd
ViewDesignEngine — 高性能 CAD 几何引擎
C++20 全栈 B-Rep 几何内核。对标 Parasolid/ACIS,覆盖曲面建模、网格处理、格式交换、CAM 制造、工程图、装配体。
快速开始
# Docker 构建(推荐)
docker run --rm -v $(pwd):/ws -w /ws vde-builder:latest \
bash -c "cmake -B build && cmake --build build -j\$(nproc)"
# 运行测试
cd build && ctest --output-on-failure -E Benchmark
依赖: CMake ≥ 3.16(建议 3.20+), Ninja(推荐), C++20, Eigen 3, nlohmann/json, GoogleTest。
三个第三方依赖优先 find_package,找不到时经 FetchContent 下载;离线环境可指向仓库内本地目录
(见 构建指南 的 FETCHCONTENT_SOURCE_DIR_* 用法)。
模块总览
工程由 13 个几何内核模块 + 11 个独立业务模块 组成,共 24 个 CMake 目标。
几何内核(include/vde/)
| 模块 | 命名空间 | 关键能力 |
|---|---|---|
foundation |
vde::foundation |
数学类型、公差、精确谓词、结构化日志、STEP/IGES/XT/SAT/JT/IFC/STL/OBJ/PLY/GLTF/3MF/VRML/COLLADA/AMF/DXF |
core |
vde::core |
点线面、AABB、凸包、多边形、Voronoi、ICP、事务、撤销栈、拓扑压缩、SIMD |
compute |
vde::compute |
GPU/CPU 计算后端抽象(CPU SIMD + CUDA 挂载点)、B-Rep→Mesh 桥接 |
curves |
vde::curves |
Bezier/B-Spline/NURBS 曲线曲面、G0-G3 连续、Sweep/Loft/Net、曲面求交/偏移/匹配/延伸/光顺、Class-A 分析、细分曲面、点云逆向 |
mesh |
vde::mesh |
半边网格、Delaunay 2D/3D、CDT、QEM 简化、平滑、Marching Cubes、网格布尔、FEA 网格、测地线、切片、体素化、逆向工程 |
spatial |
vde::spatial |
BVH (SAH)、增量 BVH、Octree、KD-Tree、R-Tree (STR)、宽相位碰撞 |
boolean |
vde::boolean |
2D 布尔、网格布尔、多边形偏移 |
collision |
vde::collision |
GJK/EPA、SAT、射线-三角形、最近点查询、连续碰撞检测 (CCD) |
sdf |
vde::sdf |
15+ 隐式图元、CSG 树、可微分几何、梯度优化、SDF→Mesh、Torch 集成 |
brep |
vde::brep |
B-Rep 拓扑、SSI 布尔、直接建模、特征树/拓扑命名、特征识别、装配、工程图、PMI/GD&T、钣金、FFD |
sketch |
vde::sketch |
2D 草图约束求解 |
capi |
vde::capi |
C API 跨语言互操作 |
render |
vde::render |
视口布局、剖视、大装配 LOD/渲染 |
独立业务模块(include/vde_*)
| 模块 | 命名空间 | 关键能力 |
|---|---|---|
vde_cam |
vde::cam |
2.5/3/5 轴 CAM 策略、刀具路径、G 代码导入、后处理器 |
vde_drafting |
vde::drafting |
制图标准、图层标准、图纸 |
vde_pdm |
vde::pdm |
BOM 表、材料库、质量反馈 |
vde_mechanism |
vde::mechanism |
运动仿真、运动链 |
vde_param |
vde::param |
参数化管理器(表达式绑定) |
vde_expression |
vde::expression |
表达式求值引擎 |
vde_event |
vde::event |
更新通知/事件 |
vde_infra |
vde::infra |
并发数据结构、性能调优 |
vde_ui |
vde::ui |
Gizmo、选择管理器、视口 API |
vde_license |
vde::license |
许可证管理 |
vde_platform |
vde::platform |
平台抽象 |
格式支持
| 格式 | 导入 | 导出 | 说明 |
|---|---|---|---|
| STEP (AP203/214/242) | ✅ | ✅ | 工业 CAD 交换标准,含 PMI/GD&T 往返 (AP242) |
| IGES (5.3) | ✅ | ✅ | 传统制造业格式 |
| Parasolid XT | ✅ | ✅ | Siemens 原生格式(文本+二进制) |
| ACIS SAT/SAB | ✅ | ✅ | Dassault 原生格式 |
| JT (ISO 14306) | ✅ | ✅ | 轻量化可视化格式 |
| IFC (2x3/4/4.3) | ✅ | — | BIM 建筑信息模型,语义实体双向转换 |
| glTF 2.0 / GLB | ✅ | ✅ | 实时 3D / Web |
| STL / OBJ / PLY | ✅ | ✅ | 通用网格 / 3D打印 |
| 3MF / AMF / VRML / COLLADA | ✅ | ✅ | 增材制造 / 可视化格式 |
| DXF | ✅ | ✅ | 2D CAD 交换(ASCII/二进制,R12–R2018 主要实体) |
| DWG | ✅ | ⚠️ R12 原生写 | 原生读 AC1009–AC1032;写侧 R12(AC1009)原生,R13+ 需转换器 |
| DWT / DWS | ✅ | — | 按 DWG 容器原生读(不保留模板/标准语义) |
| DWFx / DWF | DWFx 原生(2D 子集) / DWF6 转换器 | — | DWFx XPS 路径:Path/Fill/Glyphs → DXF 图元 |
| 3DXML | ✅ | — | XML tessellation;CATIA V5_CFV3 二进制仍需转换器 |
| VDA-FS | ✅(子集,DEGRADED) | — | CURVE/SURF/CONS/FACE 解析;精确 NURBS 曲面重建待补 |
| Rhino 3DM | 可选 openNURBS | — | VDE_USE_OPENNURBS=ON 时读网格/render mesh;默认走转换器 |
| 专有格式(SLDPRT/CATPART/NX/…) | 转换器 | — | 统一识别 + import_cad();无转换器时明确报错,不伪造成功 |
完整 43 个格式条目(28 原生 + 15 转换器)与能力边界见 格式支持矩阵。
测试
| 类别 | 状态 |
|---|---|
| 核心回归测试(退化/极端/薄壁/大面数) | ✅ |
| 模糊测试(SDF/布尔/格式往返+持续模式) | ✅ |
| 性能基准(布尔/MC/IO) | ✅ |
| CI/CD (GitHub/Gitea Actions + ASan/UBSan/TSan/Valgrind/Codecov) | ✅ |
文档
- 文档首页
- 快速入门
- 架构概览
- 模块说明书
- FAQ 与速查(中文) · Onboarding & FAQ (English)
- 术语表(中英双语)
- 版本管理规范
- 竞品深度分析
- 严谨差距分析
- 改进路线图
- 曲面能力加固计划
- CHANGELOG
许可证
Apache License 2.0 — 详见 LICENSE
Releases
1
ViewDesignEngine v1.0.0
Latest
Languages
C++
91.6%
Python
3.8%
CMake
1.5%
C
1.3%
Fortran
0.5%
Other
0.9%