DGOneGizmo 用户文档（UE5.5 ~ UE5.7，v2.4.0）

1. 插件简介

DGOneGizmo 是一个面向 Unreal Engine 5 的尺寸测量与可视化插件，支持：

• 在视口中对对象显示真实尺寸（X/Y/Z）。
• 对编辑器选中对象或运行时跟踪列表绘制可视化边框与局部坐标轴。
• 在 3D 视角中进行两点测距（支持持久测量、预览状态、橡皮擦与清空）。
• 间距测量：点击两个 Actor 即可自动计算最小表面间距，无需手动对准表面——基于迭代最近点投影算法。
• 骨骼网格体测距点支持“深度/光标优先拾取 + 顶点吸附（静态/变形混合）”；编辑器使用视口 HitProxy，运行时使用光标下命中 + 射线。
• 线段/轴线支持视距自适应粗细与柔化叠加渲染（降低遮挡感）。
• 标签面板支持同色边框与从 Bounding Box 角点引导线，以及拥挤场景去重叠与 +N 聚合提示。
• 提供全局偏好配置（单位、显示、精度、刷新频率、检测通道、快捷键等）。
• Editor：关卡工具栏菜单 + UDGOneGizmoEditorSubsystem。
• Runtime（PIE / Standalone / 打包）：UDGOneGizmoRuntimeSubsystem 提供与编辑器侧同一套可视化与测距逻辑（通过共享绘制与测量模块实现）。
• Runtime 场景编辑（可选）：专用 ADGOneRuntimeGizmoPlayerController / ADGOneRuntimeGizmoPawn / ADGOneRuntimeGizmoGameMode，在服务器维护的复制白名单（由跟踪列表中的 AActor 推导）内对物体进行选择与变换编辑（平移+旋转）；ADGOneRuntimeEditAuthorityActor 承载白名单复制。

2. 功能总览

2.1 尺寸显示（Bounds）

• 支持两种尺寸基准：
  • World AABB：世界空间轴对齐包围盒，直观反映当前场景占用体积。
  • Local Bounds：局部原始尺寸，不受世界旋转影响。
• 支持单对象与多对象（合并包围盒）计算。

2.2 可视化边框