class

CArcUIWorldWidgetRenderer

Renders an Arc widget tree into an offscreen engine texture so the scene renderer can draw it as a real in-world quad (nameplates, ping markers). It reuses Arc's own CArcUIRenderer against the bridge-adopted device — it is not a second UI renderer, just a second target — and records into the engine's current command buffer through the RHI facade, one small render pass per widget. Each widget keeps its own resolution-sized target and is only re-rendered when the screen stack marks it dirty (content changed or the distance LOD bucket moved), so an idle nameplate costs nothing per frame.

Module
ArcUI
Header
#include "ArcUI/CArcUIWorldWidgetRenderer.h"
Namespace
Mowo

The offscreen pass runs under the engine's negative-height (Vulkan Y-flip) viewport, so the produced texture is vertically mirrored relative to the UI; the world-widget quad shader reads it back with a matching V so it lands right-side-up. Colours are written in the overlay's BGRA8 space.

Constructors

SignatureNameDescription
CArcUIWorldWidgetRenderer()CArcUIWorldWidgetRenderer
~CArcUIWorldWidgetRenderer()~CArcUIWorldWidgetRenderer
CArcUIWorldWidgetRenderer(const CArcUIWorldWidgetRenderer&) = deleteCArcUIWorldWidgetRenderer

Public functions

ReturnsNameDescription
CArcUIWorldWidgetRenderer&operator=
boolIsAvailableTrue once the bridge device is up and Arc's offscreen pipelines built.
boolEnsureRenderer
uint32_tRecordPending
Ref<Image2D>RenderWidgetRenders widget into owner's cached target at width x height and returns the target's colour image for the scene renderer to sample.
voidReleaseDrops the cached target for an owner that is no longer visible.
voidClearDrops every cached target (device teardown / world change).

Function details

CArcUIWorldWidgetRenderer

C++
CArcUIWorldWidgetRenderer()

~CArcUIWorldWidgetRenderer

C++
~CArcUIWorldWidgetRenderer()

CArcUIWorldWidgetRenderer

C++
CArcUIWorldWidgetRenderer(const CArcUIWorldWidgetRenderer&) = delete

operator=

C++
CArcUIWorldWidgetRenderer& operator=(const CArcUIWorldWidgetRenderer&) = delete

IsAvailable

C++
bool IsAvailable() const

True once the bridge device is up and Arc's offscreen pipelines built. Everything no-ops (returning null textures) until it is — the screen stack then keeps the widget on the screen-space fallback.

EnsureRenderer

C++
bool EnsureRenderer()

RecordPending

C++
uint32_t RecordPending()

RenderWidget

C++
Ref<Image2D> RenderWidget(uint64_t owner, const Arcf::TSharedPtr<Arcf::AWidget>& widget, uint32_t width, uint32_t height, bool forceRedraw)

Renders widget into owner's cached target at width x height and returns the target's colour image for the scene renderer to sample. Returns the existing image (no GPU work) when width/height match the cached target and forceRedraw is false. Returns null when unavailable.

Release

C++
void Release(uint64_t owner)

Drops the cached target for an owner that is no longer visible.

Clear

C++
void Clear()

Drops every cached target (device teardown / world change).

Generated from ArcUI/CArcUIWorldWidgetRenderer.h via arcui.json · Nov 4, 2026Version 1.0.0