测量功能#

测量功能用于在视图区中快速测量两个点之间的空间距离。

当前测量功能主要支持点到点距离测量。用户依次选择两个点后，系统会在视图区绘制测量线、端点标记和距离标签。

基本概念#

测量点是用户在视图区中点击得到的空间点。通常情况下，它来自鼠标命中的模型表面。

每个测量点会记录：

内容	说明
世界坐标点	测量计算使用的三维坐标。
拾取来源	实际命中的对象，以及当前拾取范围解析出的对象。

当两个有效测量点被选中后，系统会生成一条测量结果。测量结果包含起点、终点、两点距离、三轴分量差、视图区中的测量线和距离标签。距离单位为米。

将鼠标悬停到距离标签上，可以查看起点节点、终点节点，以及 dx / dy / dz 三个方向的分量差。

进入测量模式#

顶部工具栏中有一个测量按钮，图标类似圆规，悬停提示为“测量距离 (M)”。

操作步骤：

1. 在 FlexGym 中打开或创建场景。
2. 点击顶部工具栏中的测量按钮。
3. 底部状态栏显示“测量：选择第一个点 | Esc 退出”。
4. 在视图区中点击第一个测量点。
5. 状态栏切换为“测量：选择第二个点 | Esc 取消”。
6. 再点击第二个测量点。
7. 系统生成测量线、端点标记和距离标签。

也可以按 M 快速开启或关闭测量模式。当光标位于输入框、文本区域或可编辑文本中时，M 会作为普通输入处理，不会触发测量工具。

测量流程#

进入测量模式后，第一次点击会记录起点，并显示黄色端点标记。此时移动鼠标到另一个可拾取对象上，视图区会显示黄色虚线预览段、终点预览标记和临时距离标签。

第二次点击有效点后，测量完成。正式结果会显示为：

• 蓝色测量线。
• 两个蓝色端点。
• 距离标签。
• 标签右侧的 x 删除按钮。

测量完成后，当前草稿会被清空。你可以继续选择下一组起点和终点，创建多条测量结果。

查看结果#

测量线中间会显示距离标签。标签数值使用全局数值显示精度，当前默认显示 5 位小数，设置范围为 3 到 8 位。调整全局数值精度只影响显示，不改变场景数据。

标签悬停提示会显示三轴分量差：

字段	说明
dx	终点 X 坐标 - 起点 X 坐标。
dy	终点 Y 坐标 - 起点 Y 坐标。
dz	终点 Z 坐标 - 起点 Z 坐标。

分量差适合判断两个点在某个方向上的偏移量。例如只关心高度差时，可以重点查看 dz；只关心左右间距或前后间距时，可以结合当前坐标轴方向查看 dx 或 dy。

删除与清空#

每条正式测量标签右侧都有 x 删除按钮。点击后，该条测量线、端点和标签会被移除，不影响其他测量结果。

当测量模式开启，并且已有测量结果时，底部状态栏右侧会显示“清空”按钮。点击“清空”后，所有测量结果和当前草稿都会被删除，测量模式仍然保持开启。

如果已经选择了第一个点，但还没有选择第二个点，可以按 Esc 取消当前草稿。此时已完成的测量结果不会被删除。当前没有草稿时，再按 Esc 会退出测量模式。

与拾取范围的关系#

测量功能会受到当前拾取范围影响。顶部工具栏中可以切换拾取范围，例如基础对象、Link 或 Robot。

拾取范围	测量行为
基础对象	更接近实际点击到的几何或节点，适合测量具体表面点。
Link	点击子几何时解析到所属 Link，适合测量机器人连杆之间的位置关系。
Robot	点击机器人部件时解析到机器人级对象，适合快速确认整机位置。