KCP19-CI bd087d03d6
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
docs(release): record 1.0.491 fourth origin sync (Wave21 IGES face orientation / zero-copy import caches) and final 10599-test regression
2026-11-23 02:52:07 +08:00

ViewDesignEngine — 高性能 CAD 几何引擎

C++20 B-Rep 几何内核 + 应用层。几何/格式内核可独立嵌入;CAM、工程图、装配、钣金、PMI 等应用模块是可用子集,不是商业级完整实现。能力真实性与差距见 审计文档。

Version C++ License Build Tests Modules

快速开始

# 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。

文档

许可证

Apache License 2.0 — 详见 LICENSE

S
Description
No description provided
Readme
3.7 GiB
2026-07-27 07:08:22 +00:00
Languages
C++ 91.6%
Python 3.8%
CMake 1.5%
C 1.3%
Fortran 0.5%
Other 0.9%