ShaderImage QML Type

Bietet Shader-Programmen Zugriff auf „Image“. Mehr…

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• access : enumeration
• format : enumeration
• layer : int
• layered : bool
• mipLevel : int

Ausführliche Beschreibung

Um den Inhalt von Texturen für Lese- und Schreibvorgänge in einem Shader verfügbar zu machen, müssen sie als ShaderImage bereitgestellt werden. Texturen können aus mehreren Mip-Ebenen, Ebenen und Flächen bestehen. Durch die Deklaration eines ShaderImage lässt sich zusätzlich festlegen, auf welche Ebene, Ebene oder Fläche des Texturinhalts zugegriffen werden soll.

Damit ShaderImage ordnungsgemäß funktioniert, muss es als Wert eines Parameters zugewiesen werden und auf ein gültiges Qt3D.Render.AbstractTexture verweisen.

Handelt es sich bei der referenzierten Textur um ein eindimensionales Array, ein zweidimensionales Array, eine dreidimensionale Textur, eine Cube-Map, ein Cube-Map-Array oder eine zweidimensionale Multisample-Array-Textur, ist es möglich, entweder die gesamte Texturstufe oder eine einzelne Ebene bzw. Fläche der Texturstufe zu binden. Dies lässt sich über die Eigenschaft „ layered “ steuern.

Die Unterstützung für „ShaderImage“ ist nur in OpenGL 4 und teilweise in OpenGL ES 3.1 und 3.2 vorhanden.

OpenGL 4 unterstützt die folgenden Bildtypen:

OpenGL ES 3.1 unterstützt die folgenden Bildtypen:

OpenGL ES 3.2 unterstützt alle Bildtypen von OpenGL ES 3.1 sowie die folgenden:

Die erwartete Verwendung würde wie folgt aussehen:

import Qt3D.Render 2.14

Entity {
...
    Texture2D {
        id: tex2D
        ...
    }

    Material {
        parameters: Parameter {
            name: "imageUniformName"
            value: ShaderImage {
                texture: tex2D
            }
        }
        ...
    }
 ...
}

Dokumentation zu den Eigenschaften

access : enumeration

Legt fest, welche Art von Zugriff wir unseren Shader-Instanzen auf das Bild gewähren möchten. Wenn ein Shader versucht, in ein Bild zu schreiben oder daraus zu lesen, dessen Zugriffsrechte nicht kompatibel sind, ist das Verhalten undefiniert.

Der Standardwert ist „ ShaderImage.ReadWrite“.

format : enumeration

Legt das Bildformat fest, was von entscheidender Bedeutung ist, wenn Werte aus einem Shader im „ ShaderImage “ gespeichert werden.

Das Format muss nicht mit dem Format der referenzierten Textur übereinstimmen. Es muss jedoch kompatibel sein (in der Größe übereinstimmen, aber nicht unbedingt hinsichtlich des Klassentyps). Beispielsweise könnte eine Textur im Format R32F (Größe 32 Bit, Klasse 1x32) mit einem Bild im Format RGBA8I (Größe 32 Bit, Klasse 4x8) verwendet werden. Tabelle 8.27 der OpenGL-Spezifikationen zeigt die Größe und Klasse für alle unterstützten Bildformate.

Standardmäßig versucht Qt3D, das Bildformat so einzustellen, dass es mit dem der referenzierten Textur übereinstimmt.

Der Standardwert ist „ ShaderImage.Automatic“.

layer : int

Legt fest, welche Ebene der referenzierten Textur für die „ ShaderImage “ verwendet werden soll. Diese Eigenschaft hat keine Auswirkung, wenn „ layered “ auf „true“ gesetzt ist oder wenn der Typ der referenzierten Textur nicht mit Ebenen kompatibel ist.

cubeMapLayer = layer / 6
cubeMapFace = layer - (cubeMapLayer * 6)

Der Standardwert ist 0.

layered : bool

*

Wenn auf „true“ gesetzt, wird – sofern es sich bei der referenzierten Textur um ein eindimensionales Array, ein zweidimensionales Array, eine dreidimensionale Textur, eine Cube-Map, ein Cube-Map-Array oder eine zweidimensionale Multisample-Array-Textur handelt – die gesamte Ebene für alle Ebenen gebunden. Wenn auf „false“ gesetzt, wird nur die durch die Eigenschaft „ layer “ angegebene einzelne Ebene gebunden.

Der Standardwert ist „ false “.

mipLevel : int

Legt fest, welches mipLevel der referenzierten Textur für die „ ShaderImage “ verwendet werden soll.

Der Standardwert ist 0.