ProceduralSkyMaterial QML Type

A gradient-based sky material compatible with ProceduralSkyTextureData. More...

• List of all members, including inherited members

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.