检查曲线是否与平面平行 · CurvePlaneParallel
检查平面曲线是否与指定平面在角度容差范围内平行
📖 功能概述
判断一条平面曲线是否与指定的参考平面平行。分两种情况处理：
- 直线 — 检测直线方向与参考平面法向是否垂直（即直线在平面内）
- 非直线 — 提取曲线的拟合平面法向量，检测其与参考平面法向量是否同向（角度差在容差内）
参考平面默认为世界 XY 平面，参考平面端口默认隐藏。
📥 输入参数
| 名称 | 类型 | 可见性 | 说明 |
|---|---|---|---|
| 曲线 (C) | Curve | 正常 | 要检查的平面曲线 |
| 平面 (P) | Plane | 默认隐藏 | 参考平面，默认 WorldXY |
| 容差 (T) | Number | 正常 | 角度容差（度），默认 1.0° |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 结果 (P) | Boolean | 曲线与平面是否平行 |
🧠 工作流程
1
输入曲线 + 平面 + 容差
→
2
判断曲线类型：
直线 / 曲线
直线 / 曲线
→
3
提取方向向量或
拟合平面法向量
拟合平面法向量
→
4
与参考平面法向量
比较角度
比较角度
→
5
输出 true/false
🧪 典型使用场景
- 构件筛选 — 从大量曲线中筛选出与指定平面对齐（平行）的构件
- 方向校验 — 在加工前确认曲线是否在正确的平面方向上
- 自动化处理 — 配合其他组件实现条件分支，只对平行曲线执行后续操作
⚠️ 注意事项
- 如果输入曲线非平面曲线，组件会发出警告"结果可能不准确"
- 角度容差为度数，默认 1.0°；负数会被自动取绝对值
- 直线判断标准是其方向与平面法向垂直（90°±容差）
- 非直线判断标准是其拟合平面法向与参考平面法向平行（0°或180°±容差）
📋 组件信息
| 名称 | 检查曲线是否与平面平行 |
| 英文名 | CurvePlaneParallel (CP) |
| 分类 | LK → Curve |
| 基类 | GH_Component |
| 端口隐藏 | 平面端口默认隐藏 |
| GUID | 需从源码获取 |