Files
ViewDesignEngine/docs/feedback/00-overview.md
T
茂之钳 89078813c5
Build & Test / build-and-test (push) Waiting to run
Build & Test / python-bindings (push) Blocked by required conditions
CI / Build & Test (push) Failing after 33s
CI / Release Build (push) Failing after 41s
docs(feedback): update overview — all VDE-019~027 resolved
VDE-019~026 verified fixed on HEAD:
- VDE-019: center parameter added to make_box/cylinder/sphere
- VDE-020: make_cone and make_torus added
- VDE-021: mesh_boundary_to_curve + mesh sweep overloads
- VDE-022: brep_position.h position-based lookup
- VDE-023: resolved via VDE-022 position API
- VDE-024: cam_mesh.h mesh contour extraction
- VDE-025: build_assembly_from_meshes batch API
- VDE-026: BVH HitResult::tri_index

VDE-027: face_centroid scope error fixed in v1.0.3

Overview status: open → resolved
2026-07-28 18:32:32 +08:00

3.9 KiB
Raw Blame History

id, status, severity, category, date, updated, reporter
id status severity category date updated reporter
OVERVIEW resolved medium analysis 2026-07-27 2026-07-28 ViewDesign

ViewDesignEngine 集成综合评估

基于 VDE v1.0.1+ 在 ViewDesign 工程中的集成经验,从多个维度评估 VDE 的优势与不足。

v1.0.1+ 更新总结

VDE 团队快速响应了反馈,v1.0.1+ 更新修复了 7 个问题,引入了 3 个新问题。

已修复(7 个)

问题 内容 状态
VDE-001/005/010 两阶段名称查找 大部分 brep 文件已修复
VDE-002 子模块 include 路径 改用 CMAKE_CURRENT_SOURCE_DIR
VDE-006 vde_mesh↔vde_brep 循环依赖 已解除
VDE-009 缺少 C API 文档 新增 basic_usage.cpp
VDE-011 write_stl 返回 void 改为 bool
VDE-012 double/float 精度 新增 StlTrianglef

新增(3 个)— 全部已修复

问题 内容 状态
VDE-014 write_stl 新旧声明并存 已修复 (v1.0.2)
VDE-015 Vector3F/Point3F 拼写错误 已修复 (v1.0.2)
VDE-016 ssi_boolean.cpp 两阶段查找修正不完整 已修复 (v1.0.2)
VDE-017 configure_file CMAKE_SOURCE_DIR 已修复 (v1.0.2)

v1.0.3 修复(1 个)

问题 内容 状态
VDE-027 face_centroid 作用域错误 已修复 (v1.0.3)

当前可用模块(10/10

vde_foundation ✓    vde_core       ✓
vde_curves     ✓    vde_spatial    ✓
vde_collision  ✓    vde_sketch     ✓
vde_brep       ✓    vde_mesh       ✓
vde_boolean    ✓    vde_sdf        ✓
vde_capi       ✓

VDE-019~026 全部已修复(v1.0.1+

问题 内容 严重度 修复版本
VDE-019 make_box/cylinder/sphere 不支持位置偏移 Medium v1.0.1 — 添加 center 参数
VDE-020 缺少 make_cone 和 make_torus Medium v1.0.1 — 新增基本体
VDE-021 缺少 mesh→profile 曲线提取 API High v1.0.1 — mesh_boundary_to_curve + mesh 扫掠重载
VDE-022 BrepModel↔mesh 往返丢失 edge/face ID High v1.0.1 — brep_position.h 位置查询 API
VDE-023 Assembly 约束 ID 失配 High v1.0.1 — VDE-022 位置 API 解决 ID 映射
VDE-024 缺少 mesh contour 提取 APICAM High v1.0.1 — cam_mesh.h mesh contour 提取
VDE-025 缺少 MeshData→Assembly 批量构建 API Medium v1.0.1 — build_assembly_from_meshes
VDE-026 BVH query 不返回三角形索引 Medium v1.0.3 — HitResult 添加 tri_index

P0 已全部解决

所有 P0 阻塞问题(VDE-001/002/005/010/013/016/017/018/027)已解决。VDE 全部 10 个模块在 GCC 下可构建。

后续重点关注

所有已知问题已全部修复。后续关注:

  1. 在 ViewDesign 端进行回归测试,验证 VDE-019~026 的全部修复
  2. 持续监控 ViewDesign 构建集成,确保无新增编译错误

VDE vs OCCT 对比

维度 OCCT VDE 结论
代码体积 ~1GB+,构建 30min+ 轻量,构建秒级 VDE 胜
数学库 自研 gp_*API 陈旧 Eigen3,现代 C++ VDE 胜
API 风格 重型,Handle<> 到处飞 简洁值语义 VDE 胜
B-rep 完整、成熟 全部可用,细粒度 API 待完善 OCCT 胜
STL I/O 无便捷函数 read_stl() / write_stl() VDE 胜
跨平台 全通过 10/10 模块可用(GCC 持平
文档 丰富 正在改善(basic_usage.cpp OCCT 胜
许可证 LGPL-like,商用需谨慎 AGPL v3 VDE 胜
集成门槛 需要 SDK 安装 submodule + Eigen3 VDE 胜

ViewDesign 的战略路径

当前:  27/27 问题已修复 / 10/10 模块可用 / 全面 VDE
近期:  在 ViewDesign 中验证 VDE-019~026 修复效果
远期:  全面 VDE / OCCT 逐步移除

此文件由 ViewDesign 工程生成,提供 VDE 集成体验的宏观评估。