QuadTextureProvider QML Type

Wird verwendet, um eine Quad-Textur mithilfe eines benutzerdefinierten Fragment-Shaders zu rendern. Mehr...

Import Statement:	`import QtQuick3D.Helpers`
Since:	Qt 6.12
Inherits:	TextureProviderExtension

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

format : enumeration (since 6.12)
fragmentShader : url (since 6.12)
fragmentShaderCode : string (since 6.12)
height : int (since 6.12)
width : int (since 6.12)

Ausführliche Beschreibung

Dieser Typ wird verwendet, um Quad-Texturen mithilfe von benutzerdefiniertem Shader-Code zu rendern, was eine bequeme Möglichkeit bietet, programmierbare Texturen zu erhalten. Durch die Angabe eines Fragment-Shaders und der gewünschten Eigenschaften wird ein Pass erstellt und auf Basis der bereitgestellten Daten eine Shader-Pipeline aufgebaut, wobei die Eigenschaften als Uniform-Werte an den Fragment-Shader übergeben werden.

Voreingestellte Schlüsselwörter:

Schlüsselwort	Typ	Beschreibung
MAIN		void MAIN() ist der Einstiegspunkt. Diese Funktion muss in dem bereitgestellten Fragment-Shader immer vorhanden sein.
INPUT_UV	vec2	UV-Koordinaten für das aktuelle Fragment. Oben rechts: [1, 1] und unten links: [0, 0].
OUTPUT_SIZE	vec2	Größe der Ausgabetextur.

Benutzerdefinierte Eigenschaften werden auf Uniforms abgebildet. Sobald sich die Werte ändern, wird der aktualisierte Wert im Shader sichtbar. Dieses Konzept ist möglicherweise bereits aus ShaderEffect bekannt.

Der Name der QML-Eigenschaft und der GLSL-Variablen muss übereinstimmen. Es gibt keine separate Deklaration im Shader-Code für die einzelnen Uniforms. Stattdessen kann der Name der QML-Eigenschaft unverändert verwendet werden.

Die folgende Tabelle listet auf, wie die Typen zugeordnet werden:

QML-Typ	Shader-Typ	Anmerkungen
real, int, bool	float, int, bool
Farbe	vec4	Die Konvertierung von sRGB in lineare Werte erfolgt implizit
vector2d	vec2
Vektor3d	vec3
vector4d	vec4
Matrix4x4	mat4
Quaternion	vec4	Der Skalarwert ist `w`
Rechteck	vec4
Punkt, Größe	vec2
TextureInput	sampler2D

Ein Beispiel für die Ausgabe einer einfachen roten Textur könnte wie folgt aussehen:

Texture {
    textureProvider: QuadTextureProvider {
        width: 128
        height: 128
        fragmentShaderCode: `
            void MAIN() {
                FRAGCOLOR = vec4(1.0, 0.0, 0.0, 1.0);
            }
        `
    }
}

Ein weiteres Beispiel für das Abtasten einer „ Texture “-Eigenschaft und das Mischen mit UV-Farben:

Texture {
    textureProvider: QuadTextureProvider {
        fragmentShaderCode: `
        void MAIN() {
            vec2 uv = INPUT_UV;
            vec4 c = texture(checkers, uv);
            FRAGCOLOR = mix(c, vec4(uv, 1, 1), 0.5);
        }`

        property Texture checkers : Texture {
            source: "../shared/maps/checkers2.png"
        }
    }
}

Das Ergebnis sieht wie folgt aus:

2×2-Raster aus Zellen mit Farbverlauf in Blaugrün, Weiß, Blau und Magenta

Hinweis: Die Bereitstellung eines Vertex-Shaders wird nicht unterstützt, nur ein Fragment-Shader.

Hinweis: Wenn „ Texture “-Eigenschaften angegeben werden, erfolgt die Darstellung erst, wenn die abhängigen Texturen verfügbar sind.

Hinweis: Derzeitwird das Hinzufügen oder Entfernen von Eigenschaften zur Laufzeit nicht unterstützt;es können lediglich die ursprünglichen Eigenschaften geändert werden.

Siehe auch „ ShaderEffect “.