Layer3D
- Last UpdatedOct 22, 2025
- 3 minute read
Use the Layer3D node to assemble a list of entities and give them the same behavior.
Layer3D is able to handle both 3D and Legacy 2D entities.
Platform support
This node is fully supported on XR-Windows platform.
It is partially supported on XR-Portable Windows, XR-Portable iOS, XR-Portable Android, and XR-P WASM platforms.
The portable platforms do not support RectBase (Legacy).
|
XR-WIN |
XR-P-WIN |
XR-P-IOS |
XR-P-AND |
XR-P-WASM |
|---|---|---|---|---|
|
Full support |
Partial support |
Partial support |
Partial support |
Partial support |
|
|
|
|
|
|
What can be grouped into a Layer3D
The Layer3D can group the content of different entities together:
-
One or more meshes
-
One or more dummy objects
-
One or more collision meshes
-
One or more hotspots
-
One or more rects
Moving and parenting
Due to being a NodeBaseMovable node, it supports movement and parenting.
-
You can change Layer3D position, orientation, scale and visibility.
-
You can include Layer3D into a hierarchy of nodes and apply common transformations to a parent node and its children.
-
Moving transforms applies to 3D entities. Visibility changes apply also to RectBase (Legacy) and Hotspot.
ShadowsLayer3D
A local ShadowsLayer3D can override shadow parameters of its contents by setting useLocalShadowParameters to true.
It works only on contained meshes and objects.
Code example
This is a code example for the Layer3D node.
<Layer3D name="Military_Airplanes" meshes="Airport_Total|MILITARY_F18,Airport_Total|MILITARY_Military_Apache_Texture,Airport_Total|MILITARY_Military_C132,Airport_Total|MILITARY_Military_Ch47,Airport_Total|MILITARY_Military_Ch47_vetri,Airport_Total|MILITARY_Military_F35_01_LightMap,Airport_Total|MILITARY_Military_F35_7,Airport_Total|MILITARY_Military_PipePanel_Diffuse001,Airport_Total|MILITARY_Military_polymsh_detached120,Airport_Total|MILITARY_Military_polymsh013,Airport_Total|MILITARY_Military_polymsh693" title="Military Airplanes"/>
Layer3D fields
These are the fields for Layer3D node. Only the node-specific fields are indicated, not fields obtained by inheritance.
Field inheritance: NodeBase > NodeBaseMovable > Layer3D
|
Fields |
Type |
Use |
Default value |
Description |
|---|---|---|---|---|
|
castShadows |
sbool |
Optional |
false |
Enable shadow casting for layer3D contents. Works when useLocalShadowParameters is true. |
|
cmeshes |
mstring |
Optional |
Not set |
The names (including pipes) of the collision meshes included in the layer. |
|
fadeTime |
sfloat |
Optional |
1 |
Visible/not visible transition time. |
|
hotspots |
mstring |
Optional |
Not set |
The names of Hotspot nodes included in the layer. |
|
meshes |
mstring |
Optional |
Not set |
The names (including pipes) of the meshes included in the layer. |
|
objects |
mstring |
Optional |
Not set |
The names (including pipes) of the dummy objects included in the layer. |
|
receiveShadows |
sbool |
Optional |
false |
Enable shadow receiving for layer3D contents. Works when useLocalShadowParameters is true. |
|
rects |
mstring |
Optional |
Not set |
The names of RectBase (Legacy) nodes included in the layer. |
|
title |
string |
Optional |
Not set |
Layer text to display. |
|
useLocalShadowParameters |
sbool |
Optional |
false |
Changes the default Layer3D content shadow characteristics. |
|
useLocalTransform |
sbool |
Optional |
false |
When set to true, Layer3D overrides the transform of the registered 3D nodes. When set to false, Layer3D controls only the visibility. |
|
visibilityMode |
senum |
Optional |
direct |
Select between direct transition or fade transition. |