From 70c334bcf9b690c3129e6dd86a9601712ea26d12 Mon Sep 17 00:00:00 2001 From: hm-thinkbook16p Date: Fri, 31 Jul 2026 12:51:40 +0800 Subject: [PATCH] feedback: add VDE-123 Hole Wizard + Rib, VDE-124 Weld Geometry, VDE-125 Surface Core Tools --- docs/feedback/VDE-123.md | 121 ++++++++++++++++++++++++++++ docs/feedback/VDE-124.md | 129 +++++++++++++++++++++++++++++ docs/feedback/VDE-125.md | 170 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 420 insertions(+) create mode 100644 docs/feedback/VDE-123.md create mode 100644 docs/feedback/VDE-124.md create mode 100644 docs/feedback/VDE-125.md diff --git a/docs/feedback/VDE-123.md b/docs/feedback/VDE-123.md new file mode 100644 index 0000000..edfec6b --- /dev/null +++ b/docs/feedback/VDE-123.md @@ -0,0 +1,121 @@ +# VDE-123: 异形孔向导 + 加强筋创建 + +**Date**: 2026-07-31 +**Severity**: P0 (mechanical CAD 基础特征) +**Status**: Submitted + +## Summary + +ViewDesign 对标 SolidWorks/CATIA 需要两种核心机械特征： +1. **异形孔向导 (Hole Wizard)**: 沉头孔、埋头孔、螺纹孔等的参数化创建 +2. **加强筋 (Rib)**: 从草图轮廓创建加强筋特征 + +VDE 目前仅有 `create_threaded_hole`(fastener_library.h)，远不具备专业级孔向导能力。 +`create_rib` 完全不存在。 + +## Gap Analysis + +### 异形孔向导 + +| 功能 | SolidWorks | VDE 现状 | +|------|-----------|---------| +| 柱形沉头孔 (Counterbore) | ✅ | ❌ | +| 锥形埋头孔 (Countersink) | ✅ | ❌ | +| 沉头盲孔 (Counterdrill) | ✅ | ❌ | +| 简单直孔 (Simple) | ✅ | ❌ | +| 螺纹孔 (Tapped) | ✅ | ⚠️ 仅有 `create_threaded_hole` | +| 锥管螺纹孔 (Pipe Tap) | ✅ | ❌ | +| 从草图点批量创建 | ✅ | ❌ | +| 孔标注 (工程图) | ✅ | ❌ | +| 装配孔系列 | ✅ | ❌ | +| 底孔直径自动计算 (ISO/ANSI) | ✅ | ❌ | + +### 加强筋 + +| 功能 | SolidWorks | VDE 现状 | +|------|-----------|---------| +| 平行于草图平面 (Parallel) | ✅ | ❌ | +| 垂直于草图平面 (Normal) | ✅ | ❌ | +| 线性/自然拔模 | ✅ | ❌ | +| 厚度双向/单向/中间面 | ✅ | ❌ | +| 开放轮廓自动延伸 | ✅ | ❌ | + +## Proposed API + +```cpp +namespace vde::brep { + +// ═══════════════════════════════════════════════════════════ +// Hole Wizard (异形孔向导) +// ═══════════════════════════════════════════════════════════ + +enum class HoleType { Simple, Counterbore, Countersink, Counterdrill, Tapped, PipeTap }; +enum class HoleEndCondition { Blind, ThroughAll, UpToNext, UpToFace, UpToVertex }; +enum class ThreadStandard { ISO, ANSI, JIS, GB }; + +struct HoleWizardSpec { + HoleType type; + // 尺寸规格 + double diameter = 10.0; + double depth = 20.0; + // 沉头/埋头 + double cbore_diameter = 0.0; + double cbore_depth = 0.0; + double csink_angle_deg = 90.0; + // 螺纹 + double thread_depth = 0.0; + ThreadStandard thread_std = ThreadStandard::ISO; + std::string thread_size = "M10x1.5"; + // 尾端 + HoleEndCondition end_condition = HoleEndCondition::Blind; + double tip_angle_deg = 118.0; + // 近端/远端曲面 + int start_face_id = -1; + int end_face_id = -1; +}; + +[[nodiscard]] BrepModel create_hole_wizard( + const BrepModel& body, + const core::Point3D& position, + const core::Vector3D& direction, + const HoleWizardSpec& spec); + +[[nodiscard]] std::vector create_holes_from_points( + const BrepModel& body, + const std::vector& positions, + const core::Vector3D& direction, + const HoleWizardSpec& spec); + +// 底孔直径查询表 +[[nodiscard]] double tap_drill_size( + const std::string& thread_size, + ThreadStandard standard = ThreadStandard::ISO, + double engagement_percent = 0.75); + +// ═══════════════════════════════════════════════════════════ +// Rib (加强筋) +// ═══════════════════════════════════════════════════════════ + +enum class RibOrientation { ParallelToSketch, NormalToSketch }; +enum class RibThicknessDirection { OneSide, BothSides, MidPlane }; + +struct RibParams { + double thickness = 2.0; + RibOrientation orientation = RibOrientation::NormalToSketch; + RibThicknessDirection thickness_dir = RibThicknessDirection::BothSides; + double draft_angle_deg = 0.0; + bool closed_loop = false; +}; + +[[nodiscard]] BrepModel create_rib( + const BrepModel& body, + const std::vector& sketch_contours, + const rib_params& params); + +} // namespace vde::brep +``` + +## Impact + +- 异形孔向导：机械零件中 30%+ 的特征是孔特征，无此功能严重影响可用性 +- 加强筋：注塑件/铸造件设计的基础特征，缺失即无法完成基本零件设计 diff --git a/docs/feedback/VDE-124.md b/docs/feedback/VDE-124.md new file mode 100644 index 0000000..e572eb6 --- /dev/null +++ b/docs/feedback/VDE-124.md @@ -0,0 +1,129 @@ +# VDE-124: 焊接几何创建 + +**Date**: 2026-07-31 +**Severity**: P0 (mechanical CAD 基础特征) +**Status**: Submitted + +## Summary + +VDE 目前仅有 `AssemblyFeatureType::WeldJoint` 枚举标记，无任何实际焊接几何创建函数。 +焊接是机械设计的基础需求，对标 SolidWorks Weldments 需补充完整的焊接几何能力。 + +## Gap Analysis + +| 功能 | SolidWorks 对应 | VDE 现状 | +|------|----------------|---------| +| 角焊缝 (Fillet Weld) | ✅ | ❌ | +| 坡口焊缝 (Groove Weld: V/J/U) | ✅ | ❌ | +| 塞焊 (Plug Weld) | ✅ | ❌ | +| 槽焊 (Slot Weld) | ✅ | ❌ | +| 焊道几何生成 | ✅ (沿边扫掠) | ❌ | +| 焊接符号 3D 标注 | ✅ | ❌ (仅 PMIType 枚举) | +| 焊接切割清单 | ✅ | ❌ | +| 结构构件型材库 | ✅ (工字钢/槽钢/角钢/方管) | ❌ | + +## Proposed API + +```cpp +namespace vde::brep { + +// ═══════════════════════════════════════════════════════════ +// Weld Types (焊接类型) +// ═══════════════════════════════════════════════════════════ + +enum class WeldJointType { + Fillet, // 角焊缝 (三角形截面) + GrooveV, // V 型坡口焊缝 + GrooveJ, // J 型坡口焊缝 + GrooveU, // U 型坡口焊缝 + SquareButt, // I 型对接焊缝 + BevelButt, // 单边 V 型坡口焊缝 + Plug, // 塞焊 + Slot // 槽焊 +}; + +// 焊缝参数 +struct WeldParams { + WeldJointType type = WeldJointType::Fillet; + double size = 3.0; // 焊脚尺寸 (fillet) 或焊缝宽度 + double depth = 3.0; // 熔深 + double length = 0.0; // 0=全段焊接, >0=指定长度 + double pitch = 0.0; // 间断焊间距 (0=连续焊) + bool all_around = false; // 圆周焊接符号 + bool field_weld = false; // 现场焊接符号 + std::string contour = "flat"; // flat/convex/concave +}; + +// 焊缝结果 +struct WeldBeadResult { + BrepModel bead_body; // 焊道几何体 + double volume = 0.0; // 焊料体积 (用于成本估算) + std::string weld_symbol; // 自动生成的焊接符号文本 +}; + +// ═══════════════════════════════════════════════════════════ +// API +// ═══════════════════════════════════════════════════════════ + +/// 在两零件之间创建焊缝 +[[nodiscard]] WeldBeadResult create_weld( + const Assembly& assembly, + const std::string& part_a, + const std::string& part_b, + int edge_id_a, int edge_id_b, + const WeldParams& params); + +/// 在单一边缘创建焊缝 (非装配模式) +[[nodiscard]] WeldBeadResult create_weld_on_edge( + const BrepModel& body, + int edge_id, + const core::Vector3D& weld_direction, + const WeldParams& params); + +/// 创建坡口焊缝 +[[nodiscard]] WeldBeadResult create_groove_weld( + const BrepModel& body_a, + const BrepModel& body_b, + const core::Vector3D& groove_normal, + double root_gap, double groove_angle_deg, + const WeldParams& params); + +/// 批量焊接 (焊接装配) +struct AssemblyWeldResult { + std::vector beads; + double total_weld_volume = 0.0; + std::vector cut_list; // 切割清单 +}; + +[[nodiscard]] AssemblyWeldResult create_assembly_welds( + const Assembly& assembly, + const std::vector>& weld_specs, + const WeldParams& params); + +// ═══════════════════════════════════════════════════════════ +// Structural Members (结构构件型材库) +// ═══════════════════════════════════════════════════════════ + +enum class StructuralShape { + IBeam, WideFlange, Channel, Angle, EqualAngle, + SquareTube, RectTube, RoundTube, RoundBar +}; + +struct StructuralMemberParams { + StructuralShape shape; + std::string size_spec = "100x50"; // 规格 (e.g. "I10", "50x50x6") + bool corner_treatment = false; // 端部修剪 +}; + +[[nodiscard]] BrepModel create_structural_member( + const curves::NurbsCurve& path, + const StructuralMemberParams& params); + +} // namespace vde::brep +``` + +## Impact + +- 焊接是钢结构/机械装配的基础连接方式 +- 型材库是钢结构设计的核心需求（对标 SolidWorks Weldments） +- 缺失即无法完成焊接件设计 diff --git a/docs/feedback/VDE-125.md b/docs/feedback/VDE-125.md new file mode 100644 index 0000000..7cfece0 --- /dev/null +++ b/docs/feedback/VDE-125.md @@ -0,0 +1,170 @@ +# VDE-125: 曲面核心工具 — 增厚/缝合/边界/填充/直纹/偏移 + +**Date**: 2026-07-31 +**Severity**: P0 (曲面建模基础) +**Status**: Submitted + +## Summary + +VDE 的 NURBS 曲面基础非常完备，但缺少将曲面转换为实体、以及从曲线创建曲面的核心工具。 +对标 CATIA GSD / SolidWorks Surfacing 需要以下 6 个基础函数： + +| 功能 | VDE 现状 | 说明 | +|------|---------|------| +| thicken (加厚) | ❌ | 将开放曲面体加厚为实体 | +| sew (缝合) | ❌ | 多个相邻曲面缝合为封闭壳体/实体 | +| boundary_surface (边界曲面) | ❌ | 由 U/V 向曲线网格生成曲面 | +| fill_surface (填充曲面) | ❌ | N 边封闭区域填充曲面 | +| ruled_surface (直纹曲面) | ❌ | 两条曲线之间线性插值 | +| offset_surface (曲面偏移) | ❌ | 沿法线偏移整个曲面 (3D) | + +## Gap Analysis + +### 1. Thicken (加厚曲面为实体) +- 输入: NurbsSurface + 厚度 + 方向 (单侧/双侧) +- 输出: BrepModel (实体) +- 对标: SolidWorks Thicken, CATIA GSD ThickSurface + +### 2. Sew (缝合曲面) +- 输入: vector + 缝合容差 +- 输出: BrepModel (缝合后的壳体/实体) +- 对标: SolidWorks Knit Surface, CATIA GSD Join + +### 3. Boundary Surface (边界曲面) +- 输入: U 向曲线列表 (guides) + V 向曲线列表 (profiles) +- 输出: NurbsSurface +- 对标: SolidWorks Boundary Surface, CATIA GSD Blend + +### 4. Fill Surface (填充曲面) +- 输入: N 条边界曲线 (≥3) + 连续性约束 + 内部引导线 (可选) +- 输出: NurbsSurface +- 对标: SolidWorks Filled Surface, CATIA GSD Fill + +### 5. Ruled Surface (直纹曲面) +- 输入: 两条导向曲线 + 方向参数 +- 输出: NurbsSurface (直纹面) +- 对标: SolidWorks Ruled Surface, CATIA GSD Ruled + +### 6. Offset Surface (曲面 3D 偏移) +- 输入: NurbsSurface + 偏移距离 +- 输出: NurbsSurface (等距曲面) +- 对标: SolidWorks Offset Surface, CATIA GSD Offset +- 已有 `exact_offset.h` 但仅针对曲线，非曲面 3D 偏移 + +## Proposed API + +```cpp +namespace vde::brep { + +// ═══════════════════════════════════════════════════════════ +// Thicken (加厚) +// ═══════════════════════════════════════════════════════════ + +enum class ThickenDirection { OneSide, BothSides, MidPlane }; + +struct ThickenParams { + double thickness = 1.0; + ThickenDirection direction = ThickenDirection::OneSide; + bool cap_ends = true; // 封口 + bool merge_result = true; // 合并结果实体 +}; + +[[nodiscard]] BrepModel thicken( + const BrepModel& surface_body, + const ThickenParams& params); + +// ═══════════════════════════════════════════════════════════ +// Sew (缝合) +// ═══════════════════════════════════════════════════════════ + +struct SewParams { + double tolerance = 1e-6; + bool try_make_solid = true; // 尝试生成实体 + bool merge_faces = true; // 合并共面 + bool remove_duplicates = true; // 去除重复面 +}; + +[[nodiscard]] BrepModel sew( + const std::vector& surface_bodies, + const SewParams& params = {}); + +// ═══════════════════════════════════════════════════════════ +// Boundary Surface (边界曲面) +// ═══════════════════════════════════════════════════════════ + +struct BoundarySurfaceParams { + int degree_u = 3; + int degree_v = 3; + int continuity = 2; // G0=0, G1=1, G2=2 +}; + +[[nodiscard]] curves::NurbsSurface boundary_surface( + const std::vector& u_curves, // U 向导引线 + const std::vector& v_curves, // V 向轮廓线 + const BoundarySurfaceParams& params = {}); + +// ═══════════════════════════════════════════════════════════ +// Fill Surface (填充曲面 / N 边补面) +// ═══════════════════════════════════════════════════════════ + +struct FillSurfaceParams { + int continuity = 2; // G0/G1/G2 + int n_u = 10; // U 向控制点数 + int n_v = 10; // V 向控制点数 + bool minimize_energy = true; + std::vector guide_curves; // 可选的内部引导线 +}; + +[[nodiscard]] curves::NurbsSurface fill_surface( + const std::vector& boundaries, + const FillSurfaceParams& params = {}); + +// ═══════════════════════════════════════════════════════════ +// Ruled Surface (直纹曲面) +// ═══════════════════════════════════════════════════════════ + +enum class RuledDirection { NormalToSurface, TaperedToVector, PerpendicularToVector }; + +struct RuledParams { + double length = 10.0; + RuledDirection direction = RuledDirection::NormalToSurface; + core::Vector3D reference_vector = core::Vector3D::UnitZ(); + int degree_v = 1; // 直纹面 V 向通常为 1 阶 + int num_samples = 50; +}; + +[[nodiscard]] curves::NurbsSurface ruled_surface( + const curves::NurbsCurve& guide_curve, + const RuledParams& params); + +/// 两条曲线间的直纹面 +[[nodiscard]] curves::NurbsSurface ruled_surface_between( + const curves::NurbsCurve& curve_a, + const curves::NurbsCurve& curve_b); + +// ═══════════════════════════════════════════════════════════ +// Offset Surface (曲面 3D 偏移) +// ═══════════════════════════════════════════════════════════ + +struct OffsetSurfaceParams { + double distance = 1.0; + double tolerance = 1e-6; + bool both_sides = false; + bool trim_intersections = true; +}; + +[[nodiscard]] curves::NurbsSurface offset_surface( + const curves::NurbsSurface& surface, + const OffsetSurfaceParams& params); + +} // namespace vde::brep +``` + +## Impact + +- `thicken` + `sew` 是曲面到实体的桥梁，缺失即无法完成曲面建模工作流 +- `boundary_surface` + `fill_surface` 是曲面建模的"起手式" +- `ruled_surface` 是拔模面/分型面快速创建的基础 +- `offset_surface` 是等壁厚零件设计的基础 + +这 6 个函数是曲面建模的**最小可行集**。