LabelViewer
- Last UpdatedSep 26, 2025
- 3 minute read
The LabelViewer node enables you to manage Item labels display.
-
The simulation module provides a default instance of this node called labelViewer.
-
Generally, you do not need to create a new LabelViewer. Just modify the existing default LabelViewer to customize look and feel for labels.
-
LabelViewer displays labels in both 2D and 3D modes, but only for those items that have a 3D label in the model.
-
A label mesh must be created even though the labels appear in 2D mode.
Platform support
This node is supported on XR-Windows platform only.
|
XR-WIN |
XR-P-WIN |
XR-P-IOS |
XR-P-AND |
XR-P-WASM |
|---|---|---|---|---|
|
Full support |
No support |
No support |
No support |
No support |
|
|
|
|
|
|
Auto-generated labels
Label3D dynamically creates billboard meshes for all items for which a label texture is available and the labelVisible parameter is set to true.
Activate auto generation
-
On the label3D mode, set the autoGenerate parameter to true.
Notes
-
When autoGenerate is set to false, this is restricted to all items that have a modeled label in the geometry contents.
-
When autoGenerate is set to true, label textures are automatically generated for all items that have no geometry label and labelVisible set to true.
Label positioning
-
Automatically generated labels are placed above the item center at item bounding sphere radius distance.
-
You can override label position using labelPositionOverride and labelPosition.
For more information, see Item.
LabelViewer fields
These are the fields for LabelViewer node. Only the node-specific fields are indicated, not fields obtained by inheritance.
Field inheritance: NodeBase > LabelViewer
|
Fields |
Type |
Use |
Default |
Description |
|---|---|---|---|---|
|
autoGenerate |
sbool |
Optional |
true |
Enables label autogeneration for label3d mode. |
|
labelCenterParams |
svec4 |
Optional |
500 150 960 340 |
Rect area where to put labels in labelCenter mode. |
|
labelOffset2D |
svec2 |
Optional |
0.6 |
Applies a standard 2D displacement for the label3d visualization. |
|
labelSize2D |
svec2 |
Optional |
160 40 |
2D label size. |
|
labelZoomFactor |
sfloat |
Optional |
1 |
Label zoom factor used only by labelZoom and label3d mode. |
|
labelZoomFade |
sbool |
Optional |
true |
Label gently fades in and out. |
|
labelZoomFadeTime |
sfloat |
Optional |
0.6 |
Time taken by the label to fade. |
|
mode |
senum |
Optional |
labelOld |
Selects label mode among labelOld, labelZoom, label3D, labelLeft, labelCenter and labelOver. |
|
visible |
sbool |
Optional |
false |
Show/hide labels. |
|
visibleNum |
sint |
Optional |
10 |
Max number of visualized labels. Does not work with labelOld. |