SkyMaterial QML Type

Erzeugt einen prozeduralen Himmel und generiert bildbasierte Beleuchtungsdaten. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• enableIBL : bool (since 6.12)
• fragmentShader : url (since 6.12)
• fragmentShaderCode : string (since 6.12)
• iblRenderFrames : int (since 6.12)
• iblSampleCount : int (since 6.12)
• radianceMapSize : int (since 6.12)
• skyboxMode : enumeration (since 6.12)

Ausführliche Beschreibung

SkyMaterial rendert eine Himmelsumgebung mithilfe von benutzerdefiniertem Fragment-Shader-Code in eine Cubemap. Die resultierende Cubemap kann optional gefiltert und als bildbasierte Beleuchtung (IBL) für physikalisch basiertes Rendering verwendet werden.

Der Shader wird für alle sechs Flächen der Cubemap ausgewertet und kann beliebige prozedurale Himmel, Farbverläufe oder analytische Modelle implementieren.

Die generierte Cubemap wird sowohl als sichtbarer Szenenhintergrund als auch – sofern aktiviert – als Quelle für die bildbasierte Beleuchtung verwendet.

Shader

Der Shader hat Zugriff auf die integrierte Variable „ qt_eyeDir “ (vec3), die den nicht normierten Richtungsvektor vom Mittelpunkt der Cubemap zur aktuellen Abtastrichtung bereitstellt.

Der Fragment-Shader muss einen Einstiegspunkt „ MAIN() “ definieren, der für jedes beim Rendern der Cubemap erzeugte Fragment ausgeführt wird.

Die endgültige Pixelfarbe muss in „ FRAGCOLOR “ (vec4) geschrieben werden, die die Ausgabevariable des Fragment-Shaders darstellt.

Ein minimales Shader-Beispiel:

void MAIN()
{
    vec3 dir = normalize(qt_eyeDir);

    // Output color (encoded direction as RGB)
    FRAGCOLOR = vec4(dir * 0.5 + 0.5, 1.0);
}

Benutzerdefinierte QML-Eigenschaften, die für „SkyMaterial“ deklariert wurden, werden automatisch als Uniforms im Fragment-Shader verfügbar gemacht. Der Name der Eigenschaft muss mit dem Namen der GLSL-Variablen übereinstimmen. Eine explizite Uniform-Deklaration ist nicht erforderlich.

Die folgenden Typzuordnungen werden unterstützt:

Eigenschaftsdokumentation

enableIBL : bool [default: true, since 6.12]

Legt fest, ob die generierte Himmels-Cubemap für die bildbasierte Beleuchtung verwendet wird.

Wenn diese Option aktiviert ist, generiert die Engine gefilterte Radiance- und Irradiance-Maps, die für die Umgebungsbeleuchtung und Reflexionen im physikalisch basierten Rendering verwendet werden.

Wenn diese Option deaktiviert ist, wird der Himmel nur als visueller Hintergrund gerendert und es findet keine IBL-Vorverarbeitung statt.

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch „ SceneEnvironment::lightProbe “.

fragmentShader : url [since 6.12]

Gibt einen Fragment-Shader an, der aus einer Datei oder einer Ressourcen-URL geladen wird.

Wenn sowohl „fragmentShader“ als auch „ fragmentShaderCode “ festgelegt sind, hat „ fragmentShaderCode “ Vorrang.

Wenn kein Shader angegeben ist, wird ein integrierter Debug-Shader verwendet.

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch „ fragmentShaderCode “.

fragmentShaderCode : string [since 6.12]

Gibt den Quellcode für Inline-Fragment-Shader an.

Dies verhält sich identisch zu „ fragmentShader “ und verwendet dasselbe Ausführungsmodell, dieselben integrierten Funktionen sowie dieselbe automatische Zuordnung von Eigenschaften zu Uniforms.

Wenn sowohl „ fragmentShader “ als auch „fragmentShaderCode“ festgelegt sind, hat diese Eigenschaft Vorrang.

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch „ fragmentShader “.

iblRenderFrames : int [default: 0, since 6.12]

Steuert, wie die IBL-Vorfilterung auf die einzelnen Frames verteilt wird.

• 0 — Alles in einem Frame: Die Probenakkumulation, die Normalisierung und die Bestrahlungsstärke werden alle im selben Frame ausgewertet.
• N ≥ 1 — Die „ iblSampleCount “-Werte werden auf N Schnittbilder verteilt (ceil(iblSampleCount / N) -Werte pro Bild), gefolgt von einem speziellen Bild für die Normalisierung und die Bestrahlungsstärke.

Höhere Werte verteilen den Aufwand des GGX-Vorfilters auf mehr Frames, was nützlich ist, wenn sich der Himmel selten ändert und ein hoher „ iblSampleCount “-Wert für die Bildqualität erforderlich ist.

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch „ iblSampleCount “ und „ enableIBL “.

iblSampleCount : int [default: 32, since 6.12]

Die Gesamtzahl der pro Ausgangstexel der gefilterten Strahlungskarte ausgewerteten GGX-Importanzproben. Höhere Werte reduzieren das Flimmern bei hochfrequenten Merkmalen wie beispielsweise einer Sonnenscheibe, was jedoch auf Kosten der Generierungszeit geht.

Die Werte werden auf den Bereich [1, 1024] begrenzt.

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch „ iblRenderFrames “ und „ enableIBL “.

radianceMapSize : int [default: 512, since 6.12]

Legt die Auflösung der generierten Umgebungs-Cubemap fest, die für bildbasierte Beleuchtung und Reflexionssonden verwendet wird.

Höhere Werte verbessern die Schärfe der Reflexionen und die Beleuchtungsqualität, insbesondere bei glänzenden Materialien, erhöhen jedoch den Speicherbedarf und den Rendering-Aufwand.

Die Werte werden auf die nächste Zweierpotenz gerundet und auf den Bereich [8, 2048] begrenzt.

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch skyboxMode und enableIBL.

skyboxMode : enumeration [default: SkyMaterial.Cubemap, since 6.12]

Legt fest, was der „ SkyMaterial “ als sichtbaren Hintergrund erzeugt.

Die Modi „ ScreenSpace “ entkoppeln den sichtbaren Hintergrund vom IBL-Würfel und eignen sich am besten für dynamische Himmel (z. B. sich bewegende Sonne, animierte volumetrische Wolken); „ Cubemap “ eignet sich am besten für statische Himmel. „ Cubemap “ erzwingt die Erzeugung der Cubemap, selbst wenn „ enableIBL “ auf „ false “ gesetzt ist.

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch „ radianceMapSize “ und „ enableIBL “.