点在参考平面内按逆时针/顺时针排序 · SP
将点换基到参考平面坐标，以局部 X/Y 极角排序并由按钮状态切换升序或降序
📖 功能概述
输入点列表和参考平面，将世界坐标换基到参考平面局部坐标；使用局部 X/Y 的 Atan2 极角排序，局部 Z 不参与极角计算。
💡 核心逻辑：每个点会先换算出相对于平面原点的极角，再按角度顺序输出。
🔘 按钮状态
| 状态 | 按钮文字 | 排序方向 |
|---|---|---|
| btnState1 = false（默认） | 顺时针 | 按角度升序 |
| btnState1 = true | 逆时针 | 按角度降序 |
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Points (P) | Point | 必需 | 需要排序的点列表。 |
| Plane (p) | Plane | 必需 | 参考平面。 |
| Index (i) | Integer | 可选 | 起始点序号；未指定时自动选择起点。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| Sorted Points (P) | Point | 排序后的点列表。 |
| Indices (i) | Integer | 排序结果中每个点在原列表中的索引。 |
| Starting Index (si) | Integer | 实际使用的起始点索引。 |
🧠 源码执行流程
⚠️ 注意事项
- 参考平面必须有效。
- 起始点索引使用的是排序前列表中的序号。
- 多个点相对角相同时，以距局部原点的距离作为次级排序；升序状态距离也升序，降序状态距离也降序。
- 换基用于取得局部坐标，并不是把点几何投影到平面。
📋 组件信息
| 名称 | 点在参考平面内按逆时针/顺时针排序 |
| 英文名 | SP |
| 分类 | LK → Point |
| 基类 | ButtonComponent |