struct
ArcUIWorldWidgetComponent
Binds a .ui widget tree to an entity's position in the world — the WidgetComponent analog: nameplates over players, ping markers, interaction prompts. The host drives it through CArcUIScreenStack::SyncWorldWidgets, which projects the entity's world position (plus offset) through the camera and places the built tree on the overlay at that point, scaled by distance and faded out past drawDistance. Interaction is off by default: the tree is built hit-test invisible so it never steals gameplay clicks.
- Module
- ArcUI
- Header
#include "ArcUI/ECS/Components/ArcUIWorldWidgetComponent.h"- Namespace
Mowo- Reflection
- Reflected by MowoHeaderTool
Properties
| Type | Name | Description |
|---|---|---|
std::string | assetPath | |
Vec2 | size | Default Vec2(240.0f, 72.0f). |
Vec3 | offset | Default Vec3(0.0f, 2.0f, 0.0f). |
float | scale | Default 1.0f. |
bool | distanceScale | Default true. |
float | referenceDistance | Default 8.0f. |
float | drawDistance | Default 50.0f. |
float | fadeDistance | Default 8.0f. |
bool | interactive | Default false. |
bool | visible | Default true. |
bool | worldSpace | True = render the widget tree into an offscreen texture and draw it as a real in-scene quad (depth-tested, occluded by geometry — nameplates, ping markers). False = the legacy screen-space projection onto the 2D overlay. Default true. |
bool | faceCamera | World-space quad only. True = the quad always faces the camera (billboard); false = it is oriented by the entity's transform (a plaque on a wall). Ignored by the screen-space path. Default true. |
float | worldWidth | World-space quad only. The quad's physical width in world units; its height follows the design aspect (size.y / size.x). Drives how large the nameplate reads in the scene independent of the design pixel size. Default 1.5f. |
uint32_t | maxTexels | World-space quad only. Longest edge of the offscreen render target at the reference distance; the LOD shrinks it further away so an idle far nameplate costs almost nothing to re-render. Default 512. |
bool | mounted | Default false. |
Generated from ArcUI/ECS/Components/ArcUIWorldWidgetComponent.h via arcui.json · Nov 4, 2026Version 1.0.0