DGOne Bounding Box & Tag — 用户手册

插件版本:v2.9.0 适用引擎:Unreal Engine 5.5 / 5.6 / 5.7 支持平台:Win64 / Mac / Linux 构建配置:Development + Shipping 作者:DGOne Copyright © 2024-2026 DGOne. All Rights Reserved.


文档约定


目录


1. 插件概览

1.1 定位

DGOne Bounding Box & Tag 是一款生产级运行时插件,专为大规模场景中的屏幕空间标注、目标识别、HUD 抬升显示等需求设计。它将复杂的 3D-to-2D 投影、视锥剔除、遮挡测试、动画驱动等底层逻辑封装为一个 ActorComponent,使得任何 Actor 只需挂载组件即可获得高质量的屏幕空间包围框(AABB)与标签渲染能力。

插件以纯 C++ 实现核心逻辑,但全部 API 暴露为蓝图可调用,允许策划与美术团队完全在蓝图中完成视觉与交互定制。不依赖编辑器模块,因此 Development 与 Shipping 构建均可使用。

1.2 核心能力速览

能力域 关键特性
计算引擎 三套独立引擎:AutoBounds(自动) / ManualSampling(手动) / AutoSampling(标签自动)
性能模式 三档预设:Static(零 Tick) / Dynamic(实时) / MotionTriggered(运动触发)
渲染路径 双路径并行:HUD Canvas(高吞吐) + Widget Blueprint(蓝图可定制)
视觉系统 圆角、填充透明度、边框厚度、九宫格锚点、文本三对齐、自动边缘吸附、视口适配
动画系统 8 种 Show/Hide 动画、数值滚动、矩形与颜色过渡、可挂载 Curve 资产
扩展模块 距离指示、状态条(多项)、IFF 阵营、OOB 离屏箭头、目标连线、Lock-On 锁定动画
优化体系 视锥剔除、采样阈值、距离剔除、激活相机检测、相机相对运动、自适应阈值
遮挡系统 4 种策略:Simple / Spatial / Temporal / Adaptive;支持 Channel 与 ObjectType 两种查询方式
噪点系统 随机噪点 + Perlin 噪点双引擎,支持每角点独立、距离衰减
多人同步 组件默认 Replicated,InitialTagText 带 OnRep 回调;HUD 注册按 World 隔离防止跨世界绘制
本地化 标签使用 FText,原生支持 UE 多语言系统

1.3 典型应用场景