ShaderImage QML Type

Proporciona acceso de imagen a los programas de sombreado. Más...

• Lista de todos los miembros, incluyendo los heredados

Propiedades

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

Descripción detallada

Para que el contenido de las texturas esté disponible para operaciones de lectura y escritura en un shader, es necesario exponerlas como ShaderImage. Las texturas pueden estar compuestas de varios niveles mip, capas y caras. Adicionalmente declarar un ShaderImage permite especificar a que nivel, capa o cara del contenido de la textura queremos acceder.

ShaderImage tiene que ser asignado como valor de un parámetro y hacer referencia a un Qt3D.Render.AbstractTexture válido para que funcione correctamente.

Si la textura referenciada es un array unidimensional, un array bidimensional, una textura tridimensional, un mapa cúbico, un array de mapa cúbico, o un array multi-muestra bidimensional, es posible enlazar o bien todo el nivel de textura o bien una sola capa o cara del nivel de textura. Esto puede controlarse con la propiedad layered.

El soporte para ShaderImage sólo es compatible con OpenGL 4 y parcialmente con OpenGL ES 3.1 y 3.2.

OpenGL 4 soporta los siguientes tipos de imagen:

OpenGL ES 3.1 admite los siguientes tipos de imagen:

OpenGL ES 3.2 admite todos los tipos de imagen de OpenGL ES 3.1, así como los siguientes:

El uso esperado sería el siguiente

import Qt3D.Render 2.14

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

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

Documentación de propiedades

access : enumeration

Especifica el tipo de acceso que queremos permitir desde nuestras instancias de sombreado a la imagen. Si un sombreador intenta escribir o leer de una imagen que tiene un acceso incompatible, el comportamiento es indefinido.

El valor por defecto es ShaderImage.ReadWrite.

format : enumeration

Especifica el formato de la imagen, que es esencialmente importante cuando se almacenan valores en ShaderImage desde un shader.

El formato no tiene que ser el mismo que el de la textura referenciada. Sin embargo tiene que ser compatible (coincidir en tamaño pero no necesariamente por tipo de clase). Por ejemplo una textura de formato R32F (tamaño 32bits, clase 1x32) podría ser utilizada con una imagen de formato RGBA8I (tamaño 32bits, clase 4x8). La tabla 8.27 de las especificaciones OpenGL muestra el tamaño y la clase para todos los formatos de imagen soportados.

Por defecto Qt3D intentará establecer el formato de imagen para que coincida con el de la textura referenciada.

El valor por defecto es ShaderImage.Automatic.

layer : int

Indica qué capa de la textura referenciada debe utilizarse para ShaderImage. Esta propiedad no hace nada si layered es igual a true o si el tipo de la textura de referencia no es compatible con las capas.

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

El valor por defecto es 0.

layered : bool

*

Si se establece a true, si la textura referenciada es una matriz unidimensional, matriz bidimensional, tridimensional, mapa cúbico, matriz de mapa cúbico, o textura de matriz multi-muestra bidimensional, todo el nivel será enlazado para todas las capas. Si se establece a false, sólo se vinculará la capa especificada por la propiedad layer.

El valor por defecto es false.

mipLevel : int

Mantiene qué mipLevel de la textura referenciada debe usarse para ShaderImage.

El valor por defecto es 0.