ProceduralSkyMaterial QML Type
A gradient-based sky material compatible with ProceduralSkyTextureData. More...
| Import Statement: | import QtQuick3D.Helpers |
| Since: | Qt 6.13 |
| Inherits: |
Properties
- groundBottomColor : color
(since 6.13) - groundCurve : real
(since 6.13) - groundEnergy : real
(since 6.13) - groundHorizonColor : color
(since 6.13) - skyCurve : real
(since 6.13) - skyEnergy : real
(since 6.13) - skyHorizonColor : color
(since 6.13) - skyTopColor : color
(since 6.13) - sunAngleMax : real
(since 6.13) - sunAngleMin : real
(since 6.13) - sunColor : color
(since 6.13) - sunCurve : real
(since 6.13) - sunEnergy : real
(since 6.13) - sunLatitude : real
(since 6.13) - sunLongitude : real
(since 6.13)
Detailed Description
ProceduralSkyMaterial is a GPU-based sky rendered via SkyMaterial that provides the same gradient-and-sun-disk sky model as ProceduralSkyTextureData, but with real-time updates and no CPU texture baking.
It can be used as a drop-in replacement for ProceduralSkyTextureData: set backgroundMode to SceneEnvironment.SkyMaterial and assign this type to skyMaterial instead of using a Texture with ProceduralSkyTextureData as its texture data.
Example Usage
import QtQuick3D
import QtQuick3D.Helpers
View3D {
environment: SceneEnvironment {
backgroundMode: SceneEnvironment.SkyMaterial
skyMaterial: ProceduralSkyMaterial {
sunLatitude: 35
sunLongitude: 45
skyTopColor: "#1a3a6a"
}
}
}
See also ProceduralSkyTextureData and SkyMaterial.
Property Documentation
groundBottomColor : color [default: "#282F36", since 6.13]
The color at the bottom of the ground hemisphere.
This property was introduced in Qt 6.13.
groundCurve : real [default: 0.02, since 6.13]
Controls the curvature of the ground gradient blend from horizon to bottom.
This property was introduced in Qt 6.13.
groundEnergy : real [default: 1.0, since 6.13]
Brightness multiplier for the ground hemisphere.
This property was introduced in Qt 6.13.
groundHorizonColor : color [default: "#6C655F", since 6.13]
The color of the ground at the horizon.
This property was introduced in Qt 6.13.
skyCurve : real [default: 0.09, since 6.13]
Controls the curvature of the sky gradient blend from horizon to top. Values below 1 curve toward the horizon, values above 1 toward the top.
This property was introduced in Qt 6.13.
skyEnergy : real [default: 1.0, since 6.13]
Brightness multiplier for the sky hemisphere.
This property was introduced in Qt 6.13.
skyHorizonColor : color [default: "#D6EAFA", since 6.13]
The color of the sky at the horizon.
This property was introduced in Qt 6.13.
skyTopColor : color [default: "#A5D6F1", since 6.13]
The color at the top of the sky dome.
This property was introduced in Qt 6.13.
sunAngleMax : real [default: 100.0, since 6.13]
The outer angular radius of the sun halo in degrees. The halo fades out from sunAngleMin to this value.
This property was introduced in Qt 6.13.
sunAngleMin : real [default: 1.0, since 6.13]
The angular radius of the solid sun disk in degrees.
This property was introduced in Qt 6.13.
sunColor : color [default: "#ffffff", since 6.13]
The color of the sun disk.
This property was introduced in Qt 6.13.
sunCurve : real [default: 0.05, since 6.13]
Controls the falloff curve of the sun halo between sunAngleMin and sunAngleMax. Values below 1 produce a sharp-edged halo; values above 1 produce a soft glow.
This property was introduced in Qt 6.13.
sunEnergy : real [default: 1.0, since 6.13]
Brightness multiplier for the sun disk and halo.
This property was introduced in Qt 6.13.
sunLatitude : real [default: 35.0, since 6.13]
The elevation of the sun above the horizon in degrees. 0 places the sun on the horizon; 90 places it directly overhead.
This property was introduced in Qt 6.13.
sunLongitude : real [default: 0.0, since 6.13]
The horizontal rotation of the sun around the vertical axis in degrees.
This property was introduced in Qt 6.13.