main
pr-quality / static-gate (workflows + docs claims/index + coverage plan) (push) Waiting to run
pr-quality / coverage-gate (core-pr measured baseline, opt-in) (push) Blocked by required conditions
pr-quality / fast-gate (build -> core-pr tests -> determinism) (push) Blocked by required conditions
ViewDesignEngine — 高性能 CAD 几何引擎
C++20 B-Rep 几何内核 + 应用层。几何/格式内核可独立嵌入;CAM、工程图、装配、钣金、PMI 等应用模块是可用子集,不是商业级完整实现。能力真实性与差距见 审计文档。
快速开始
# 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_* 用法)。
模块总览
工程由 30 个 CMake 模块目标 组成:11 个几何内核、2 个集成层、17 个官方/应用模块。
内核以 vde::kernel 聚合、可按 find_package(vde-kernel) 嵌入;应用层以 vde::app 聚合。
几何内核(include/vde/,11 个)
| 模块 | 命名空间 | 关键能力 |
|---|---|---|
foundation |
vde::foundation |
数学类型、公差、精确谓词、日志、序列化、格式基础设施 |
plugin |
vde::plugin |
微内核插件管理器、清单、加载/卸载、能力注册(只依赖 foundation) |
core |
vde::core |
点线面、AABB、凸包、多边形、Voronoi、ICP、事务/撤销、SIMD |
compute |
vde::compute |
CPU SIMD / CUDA 计算后端抽象、B-Rep→Mesh 桥接 |
curves |
vde::curves |
Bézier/B-Spline/NURBS、G0–G3、Sweep/Loft/Net、求交/偏移/匹配/延伸 |
mesh |
vde::mesh |
半边网格、Delaunay/CDT、QEM、平滑、Marching Cubes、FEA 网格、lattice、切片 |
spatial |
vde::spatial |
BVH (SAH)、增量 BVH、Octree、KD-Tree、R-Tree、宽相位 |
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 布尔、直接建模、TNP/特征树、装配核心、PMI 数据模型 |
集成层(2 个)
| 模块 | 命名空间 | 关键能力 |
|---|---|---|
io |
vde::io |
文件格式 IO + 跨 B-Rep/网格桥接;单向依赖内核,可 VDE_BUILD_IO=OFF 裁剪 |
cae |
vde::mesh / vde::fluid |
CAE/CFD 前处理(FEA 网格、计算域、边界层);不含结构求解器 |
官方/应用模块(include/vde_*,17 个)
| 模块 | 关键能力 |
|---|---|
vde_cam |
2.5/3/5 轴 CAM 策略、刀路、G 代码导入、后处理(策略/工艺子集) |
vde_drafting |
制图标准、图层标准、图纸、PMI 导出 |
vde_assembly |
装配、约束、阵列、实例、干涉、大装配 LOD(无生产级 GCS) |
vde_sheetmetal |
钣金展开/折弯扣除/K-factor/法兰/特征识别 |
vde_pdm |
BOM、材料库、型材库、质量反馈 |
vde_render |
视口布局、剖视、大装配渲染 |
vde_ui |
Gizmo、选择管理器、视口 API |
vde_pmi |
PMI/MBD 导出与自动生成(语义标准子集) |
vde_mechanism |
运动链/运动仿真 |
vde_param / vde_expression / vde_event |
参数化、表达式、更新通知 |
vde_infra / vde_license / vde_platform |
并发/性能、许可证、平台抽象 |
vde_sketch |
内部草图约束模块(VDE-1201:不嵌入生产求解器) |
vde_capi |
C API 跨语言互操作 |
格式支持
| 格式 | 导入 | 导出 | 说明 |
|---|---|---|---|
| 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 | ✅ | ✅ | 增材制造 / 可视化格式 |
| OFF | ✅ | ✅ | 通用网格 ASCII;官方 OFF 插件 |
| 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) | ✅ |
当前基线:全量 CTest 8,369/8,369 PASS、0 failed、35 SKIP(1.0.177 自验证);发布门禁 14/14 PASS。
文档
- 文档首页
- 快速入门
- 当前架构与能力(1.0.177)
- 能力真实性与差距审计(1.0.177)
- 追赶计划(1.0.177 基线)
- 工程现状总览(1.0.107,历史)
- 架构概览
- 插件生态分层
- 设计文档索引
- 模块说明书
- 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%