Files
ViewDesignEngine/docs/archive/12-v3.3-开发计划.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

1.9 KiB
Raw Blame History

ViewDesignEngine v3.3 工业级强化计划

制定: 2026-07-24 | 状态: 完成


1. 🎯 B-Rep 面分割(Face Splitting

当前布尔运算用 centroid 射线法分类,精度差。需要真正的面-面求交分割。

  • 实现 split_face_by_plane(face, plane) — 平面分割单个面
  • 实现 split_face_by_face(face_a, face_b) — 两个曲面求交分割
  • 集成到 brep_boolean.cpp 替换 centroid 分类
  • Validity 测试:分割后的面子集构成合法壳

2. 📐 NURBS 曲面求交

核心工业几何算法。B-Rep 布尔依赖此。

  • 实现 intersect_surfaces(surf_a, surf_b) → 交线曲线列表
  • 算法:递归细分 + bounding box 剔除 + 牛顿精化
  • 支持平面-曲面、曲面-曲面的交线计算
  • 测试:平面交平面、平面交圆柱、圆柱交球

3. 🖥️ WebGL 查看器

在线预览 GLB/STL,嵌入 Gitea Wiki。

  • 创建 viewer/ 目录,含 Three.js 单页应用
  • 拖拽上传 GLB/STL 文件,Three.js 渲染
  • 嵌入到 Wiki Home 页
  • 支持旋转、缩放、线框/实体切换

4. 📦 Linux 包

降低安装门槛。

  • 创建 packaging/DEBIAN/ 目录
  • control + rules + cmake 安装
  • make deb 目标
  • 测试 apt install ./vde-3.3.0.deb

5. 📖 教程文档

从零开始的实用指南。

  • docs/tutorial/01-quickstart.md — 5 分钟上手
  • docs/tutorial/02-sdf-modeling.md — SDF 隐式建模
  • docs/tutorial/03-brep-modeling.md — B-Rep 工业建模
  • docs/tutorial/04-export.md — STEP/STL/GLB 导出

6. 🧪 模糊测试

随机几何输入 + 断言,发现隐蔽 bug。

  • tests/fuzz/fuzz_boolean.cpp — 随机 B-Rep 布尔
  • tests/fuzz/fuzz_sdf.cpp — 随机 SDF 参数
  • tests/fuzz/fuzz_iges.cpp — 随机 IGES round-trip
  • CI 集成:每次 push 跑 100 轮模糊测试