求取点的相对坐标值 · Local Coords By Plane
将世界坐标系中的点转换为指定平面中的相对坐标值
📖 功能概述
输入一组点和一个参考平面，组件把每个点映射到参考平面的局部坐标系中，输出其相对 X、Y、Z 坐标。
💡 什么时候用？当你需要以某个工作平面、构件平面或加工基准面来理解点的位置时，这个组件比直接看世界坐标更合适。
⚙️ 工作流程
- 读取点列表与参考平面。
- 调用平面局部坐标换算。
- 拆分出相对 X、Y、Z 三个数值列表。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 点 (P) | Point | 必需 | 需要求取相对坐标的点列表。 |
| 平面 (P) | Plane | 可选 | 作为参考基准的平面。默认为 WorldXY。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 相对坐标值X (X) | Number | 点在参考平面局部坐标系中的 X 值。 |
| 相对坐标值Y (Y) | Number | 点在参考平面局部坐标系中的 Y 值。 |
| 相对坐标值Z (Z) | Number | 点在参考平面局部坐标系中的 Z 值，也可理解为离平面的相对高度。 |
🧪 示例
如果一个点位于 (5,5,10)，参考平面是 WorldXY，则输出为 X=5、Y=5、Z=10。若参考平面原点移动到 (2,2,0)，则输出变为 X=3、Y=3、Z=10。
🧩 典型使用场景
- 幕墙定位：获取构件在幕墙网格中的局部位置。
- 工作平面测量：在指定基准面下分析点分布。
- 加工坐标：把模型点转换为加工设备坐标系。
⚠️ 注意事项
- 两个输入端都叫 P，但一个是点，一个是平面。
- 若未连接平面，默认使用 WorldXY。
- 平面原点改变后，结果会跟着变化。
📋 组件信息
| 名称 | 求取点的相对坐标值 |
| 英文名 | Local Coords By Plane |
| 分类 | LK → Point |
| 基类 | GH_Component |