数字归整 · Round To Multiple
将数字按指定倍数进行归整，支持四舍五入、向上取整、向下取整
📖 功能概述
这个组件会把输入数字归整到某个指定模数的倍数上。例如当模数为 5 时，16 可以被归整为 15 或 20，具体取决于当前模式。
它适合做尺寸标准化、网格捕捉、步长控制以及规则化数值处理。
💡 直观理解：可以把它理解为把任意数字“吸附”到一组固定间距的刻度点上，而模数就是这些刻度之间的距离。
🛠️ 右键菜单模式
四舍五入
取最接近的倍数值
向上取整
取大于或等于原值的最近倍数
向下取整
取小于或等于原值的最近倍数
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 数字列表 (N) | Number | 必需 | 要执行归整的数字，可为单个值，也可为多个值。 |
| 模数 (M) | Number | 可选 | 归整的步长或倍数基准。默认值为 1。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 结果 (R) | Number | 归整后的数字列表，数量与输入保持一致。 |
🧪 示例
假设模数 M = 5，下表展示三种模式的结果：
| 原始值 | 四舍五入 | 向上取整 | 向下取整 |
|---|---|---|---|
| 3 | 5 | 5 | 0 |
| 7 | 5 | 10 | 5 |
| 12 | 10 | 15 | 10 |
| 16 | 15 | 20 | 15 |
| 19 | 20 | 20 | 15 |
🎯 典型使用场景
- 尺寸标准化：将尺寸统一到常见模数。
- 阵列步长对齐：把移动距离或间距吸附到固定步长上。
- 网格捕捉：将坐标或参数归整到格点。
- 材料规格控制：让长度符合标准规格倍数。
- 角度规则化：把角度吸附到常用角度间隔。
⚠️ 注意事项
- 模数通常应使用正数，这样归整方向与结果更直观。
- 当模数未连接时，默认值为
1。 - 切换右键模式后，组件会按照新的归整逻辑重新计算结果。
- 如果输入列表存在无效数据，结果会受到上游数据有效性的影响。
- 该组件支持右键交互，因此可直接在组件菜单中切换模式。
📌 组件信息
| 名称 | 数字归整 |
| 英文名 | Round To Multiple (RM) |
| 分类 | LK → Number |
| 基类 | RighrClickComponent |
| GUID | 977832F9-6CEF-4441-B031-B19F6F27AF99 |