SkyDome
- Last UpdatedOct 22, 2025
- 4 minute read
The SkyDome node allows you to create a fully or partially procedural sky environment. The created environment includes sun representation.
-
The sun can deeply influence the look of the SkyDome by its position, dimension, and intensity.
-
A SkyDome is required by the Ocean node to have dynamic sky and sun reflections on the water surface.
-
There must be one and only one SkyDome node a time.
Platform Support
This node is supported on XR-Windows platform only.
It's important to note that the SkyDome node is supported only in FGI-based rendering pipelines.
|
XR-WIN |
XR-P-WIN |
XR-P-IOS |
XR-P-AND |
XR-P-WASM |
|---|---|---|---|---|
|
Full support |
No support |
No support |
No support |
No support |
|
|
|
|
|
|
Dynamic and Static SkyDome
Although SkyDome is always a procedural environment representation, it can be configured to use dynamic or static sky texture.
Note: You cannot switch the mode at runtime.
|
Mode |
Sky |
Clouds |
Sun |
|---|---|---|---|
|
Dynamic |
Created procedurally depending on all the sun and clouds settings. |
Can be applied as separate texture over the procedural texture and mixed with underlaying procedural sun and sky. |
Dynamically managed and influencing procedural sky. Drawn over procedural sky and under clouds. |
|
Static |
Provisioned as a texture. Sun intensity will effect texture visualization. |
Can be included in the sky texture, but will still be represented under the sun. |
Dynamically managed. Drawn over static texture. |
If the staticTexture field is empty at loading time, the SkyDome will use dynamic sky texture; otherwise, it will be static.
We recommended the dynamic approach because it is more realistic, unless there is a specific requirement for a special type of sky (such as night sky with stars or a very cloudy sky).
Integrating with FGIState
The SkyDome dynamic sun can be linked to FgiState using the sky\proceduralSky field.
When linked, part of the SkyDome properties will be controlled by generated FGI states:
-
SkyDome sun will be aligned to the FGIState sun. Therefore, manipulating SkyDome sunAzimuth and sunElevation will produce no results.
-
SkyDome sun intensity effect will be multiplied by FGIState sun\contribution.
SkyDome fields
These are the fields for SkyDome node. Only the node-specific fields are indicated, not fields obtained by inheritance.
Field inheritance: NodeBase > SkyDome
|
Field |
Type |
Use |
Default Value |
Description |
|---|---|---|---|---|
|
clouds |
sbool |
Optional |
false |
Enables the visualization of the cloudTexture. Available only in dynamic mode. |
|
cloudsMultiplier |
sfloat |
Optional |
1 |
Customizes the cloud opacity. Available only in dynamic mode. |
|
cloudsOffset |
sfloat |
Optional |
0 |
Rotates the cloud texture UV mapping to find the best alignment. Available only in dynamic mode. |
|
cloudsSunDiskThreshold |
sfloat |
Optional |
0 |
Cloud texture points whose opacity is higher then the threshold are drawn over the sun disk. Available only in dynamic mode. |
|
cloudsTexture |
sstring |
Optional |
The grayscale texture applied to the clouds. Black areas are transparent and white areas are opaque. Available only in dynamic mode. |
|
|
domeRadius |
sfloat |
Optional |
1000 |
The radius of the dome. |
|
domeSlicesCount |
sint |
Optional |
25 |
The number of SkyDome slices. A higher number of slices means a more spherical dome. |
|
domeTextureSize |
sint |
Optional |
2048 |
The dimension of the SkyDome texture to be mapped on the Dome. The higher the size, the more details will be shown. |
|
staticTexture |
sstring |
Optional |
If not set, the SkyDome will be dynamic mode showing procedural sky and supporting separate cloudTexture. If set, the SkyDome will be static mode and will use the specified texture for the sky. |
|
|
sunAzimuth |
sfloat |
Optional |
0 |
Azimuth angle in degrees. This field can be used to move the sun clockwise and counter clockwise when the SkyDome is not linked to FGIState. |
|
sunDiskMultiplier |
sfloat |
Optional |
100 |
Used to adapt the blending of the disk with the procedural or static sky texture behind it. |
|
sunElevation |
sfloat |
Optional |
20 |
Elevation angle in degrees. Can be used to move the sun up and down when the SkyDome is not linked to FGIState. |
|
sunIntensity |
sfloat |
Optional |
1 |
Represents the sun light intensity. |
|
sunSize |
sfloat |
Optional |
1 |
Makes the sun disk bigger or smaller. |
|
translation |
svec3 |
Optional |
0 0 0 |
Center of the dome. |
|
visible |
sbool |
Optional |
true |
Shows or hides the SkyDome |