DGOneGizmo User Guide (UE5.5 ~ UE5.7, v2.4.0)

1. Plugin Overview

DGOneGizmo is a dimension measurement and visualization plugin for Unreal Engine 5. It supports:

• Displaying real object dimensions (X/Y/Z) in the viewport.
• Drawing visual bounds and local axes for editor selection or a runtime-tracked object list.
• Two-point distance measurement in 3D view (persistent workflow, preview state, eraser, and clear-all).
• Gap measurement: click two actors to automatically compute the minimum surface-to-surface distance using iterative closest-point projection — no manual surface picking required.
• Skeletal mesh measurement with depth/cursor-first picking and vertex snap (imported/skinned hybrid); the editor uses viewport HitProxy depth picking, while runtime uses hit-under-cursor plus line traces.
• Distance/axis rendering with distance-adaptive thickness and soft overlay style.
• Label panel border, bounding-box leader lines, declutter, and +N cluster hints in crowded views.
• Global preference configuration (units, display, precision, refresh rate, trace channel, hotkeys, etc.).
• Editor: level toolbar menu + UDGOneGizmoEditorSubsystem.
• Runtime (PIE / Standalone / packaged): UDGOneGizmoRuntimeSubsystem exposes the same visualization and measurement behavior as the editor (shared draw/measure utilities).
• Runtime scene editing (optional): ADGOneRuntimeGizmoPlayerController / ADGOneRuntimeGizmoPawn / ADGOneRuntimeGizmoGameMode for whitelist-based selection and transform editing (translate + rotate); ADGOneRuntimeEditAuthorityActor replicates the editable AActor list derived from the runtime tracking list.

2. Feature Overview

2.1 Dimension Display (Bounds)

• Supports two dimension references:
  • World AABB: World-space axis-aligned bounding box, intuitively reflecting occupied volume in the scene.
  • Local Bounds: Original local size, unaffected by world rotation.
• Supports both single-object and multi-object (combined bounds) calculation.

2.2 Visual Bounding Box