ShaderImage QML Type

Fournit un accès par image aux programmes de nuanceurs. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Description détaillée

Pour que le contenu des textures soit disponible pour les opérations de lecture et d'écriture dans un shader, elles doivent être exposées en tant que ShaderImage. Les textures peuvent être composées de plusieurs niveaux, couches et faces. En outre, la déclaration d'une ShaderImage permet de spécifier le niveau, la couche ou la face du contenu de la texture auquel nous voulons accéder.

Pour fonctionner correctement, le ShaderImage doit être assigné comme valeur d'un paramètre et faire référence à un Qt3D.Render.AbstractTexture valide.

Si la texture référencée est un tableau unidimensionnel, un tableau bidimensionnel, un tableau tridimensionnel, une carte cubique, un tableau de cartes cubiques ou un tableau bidimensionnel à échantillons multiples, il est possible de lier soit l'ensemble du niveau de texture, soit une seule couche ou une seule face du niveau de texture. Ceci peut être contrôlé avec la propriété layered.

La prise en charge de ShaderImage n'est possible qu'avec OpenGL 4 et partiellement avec OpenGL ES 3.1 et 3.2.

OpenGL 4 supporte les types d'images suivants :

OpenGL ES 3.1 supporte les types d'images suivants :

OpenGL ES 3.2 supporte tous les types d'images OpenGL ES 3.1 ainsi que les suivants :

L'utilisation prévue ressemblerait à ce qui suit :

import Qt3D.Render 2.14

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

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

Propriété Documentation

access : enumeration

Spécifie le type d'accès à l'image que nous voulons autoriser pour nos instances de shaders. Si un shader tente d'écrire ou de lire une image dont l'accès est incompatible, le comportement est indéfini.

La valeur par défaut est ShaderImage.ReadWrite.

format : enumeration

Spécifie le format de l'image, ce qui est essentiellement important lorsque l'on stocke des valeurs dans ShaderImage à partir d'un shader.

Le format n'a pas besoin d'être le même que celui de la texture référencée. Il doit cependant être compatible (correspondre en taille mais pas nécessairement en type de classe). Par exemple, une texture de format R32F (taille 32bits, classe 1x32) peut être utilisée avec une image de format RGBA8I (taille 32bits, classe 4x8). Le tableau 8.27 des spécifications OpenGL indique la taille et la classe de tous les formats d'image supportés.

Par défaut, Qt3D essaiera de définir le format de l'image pour qu'il corresponde à celui de la texture référencée.

La valeur par défaut est ShaderImage.Automatic.

layer : int

Indique quel calque de la texture référencée doit être utilisé pour l'image ShaderImage. Cette propriété n'a aucun effet si layered vaut true ou si le type de la texture référencée n'est pas compatible avec les calques.

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

La valeur par défaut est 0.

layered : bool

*

Si la valeur vaut true, si la texture référencée est un tableau unidimensionnel, un tableau bidimensionnel, un tableau tridimensionnel, un tableau de cubes, un tableau de cubes ou un tableau bidimensionnel à échantillons multiples, l'ensemble du niveau sera lié pour toutes les couches. Si la valeur est fixée à false, seule la couche unique spécifiée par la propriété layer sera liée.

La valeur par défaut est false.

mipLevel : int

Détient le mipLevel de la texture référencée qui doit être utilisé pour ShaderImage.

La valeur par défaut est 0.