En esta página

ShaderImage QML Type

Proporciona acceso a Image en los programas de sombreado. Más información...

Import Statement: import Qt3D.Render 2.12
In C++: QShaderImage
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Descripción detallada

Para que el contenido de las texturas esté disponible para operaciones de lectura y escritura en un shader, deben exponerse como ShaderImage. Las texturas pueden estar compuestas por varios niveles mip, capas y caras. Además, al declarar un ShaderImage se puede especificar a qué nivel, capa o cara del contenido de la textura se desea acceder.

Para que ShaderImage funcione correctamente, debe asignarse como valor de un parámetro y hacer referencia a un `Qt3D.Render.AbstractTexture ` válido.

Si la textura a la que se hace referencia es una matriz unidimensional, bidimensional o tridimensional, un mapa cúbico, una matriz de mapas cúbicos o una textura de matriz bidimensional con muestreo múltiple, es posible vincular bien todo el nivel de la textura, bien una sola capa o cara de dicho nivel. Esto se puede controlar mediante la propiedad layered.

La compatibilidad con ShaderImage solo está disponible en OpenGL 4 y, de forma parcial, en OpenGL ES 3.1 y 3.2.

OpenGL 4 admite los siguientes tipos de imagen:

Tipo GLSLEnumeración de tipos de OpenGLTipo de textura
image1DGL_IMAGE_1DTexture1D
imagen2DGL_IMAGE_2DTexture2D
imagen3DGL_IMAGE_3DTexture3D
imagen2DRectGL_IMAGE_2D_RECTTextureRectangle
imageCubeGL_IMAGE_CUBETextureCubeMap
imageBufferGL_IMAGE_BUFFERTextureBuffer
matriz1DdeimágenesGL_IMAGE_1D_ARRAYTexture1DArray
matriz2DdeimágenesGL_IMAGE_2D_ARRAYTexture2DArray
matriz de imagen cúbicaGL_IMAGE_CUBE_MAP_ARRAYTextureCubeMapArray
image2DMSGL_IMAGE_2D_MULTISAMPLETexture2DMultisample
image2DMSArrayGL_IMAGE_2D_MULTISAMPLE_ARRAYTexture2DMultisampleArray
iimage1DGL_INT_IMAGE_1DTexture1D
iimage2DGL_INT_IMAGE_2DTexture2D
iimage3DGL_INT_IMAGE_3DTexture3D
iimage2DRectGL_INT_IMAGE_2D_RECTTextureRectangle
iimageCubeGL_INT_IMAGE_CUBETextureCubeMap
iimageBufferGL_INT_IMAGE_BUFFERTextureBuffer
iimage1DArrayGL_INT_IMAGE_1D_ARRAYTexture1DArray
iimage2DArrayGL_INT_IMAGE_2D_ARRAYTexture2DArray
iimageCubeArrayGL_INT_IMAGE_CUBE_MAP_ARRAYTextureCubeMapArray
iimage2DMSGL_INT_IMAGE_2D_MULTISAMPLETexture2DMultisample
iimage2DMSArrayGL_INT_IMAGE_2D_MULTISAMPLE_ARRAYTexture2DMultisampleArray
uimage1DGL_UNSIGNED_INT_IMAGE_1DTexture1D
uimage2DGL_UNSIGNED_INT_IMAGE_2DTexture2D
uimage3DGL_UNSIGNED_INT_IMAGE_3DTexture3D
uimage2DRectGL_UNSIGNED_INT_IMAGE_2D_RECTTextureRectangle
uimageCubeGL_UNSIGNED_INT_IMAGE_CUBETextureCubeMap
uimageBufferGL_UNSIGNED_INT_IMAGE_BUFFERTextureBuffer
uimage1DArrayGL_UNSIGNED_INT_IMAGE_1D_ARRAYTexture1DArray
uimage2DArrayGL_UNSIGNED_INT_IMAGE_2D_ARRAYTexture2DArray
uimageCubeArrayGL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAYTextureCubeMapArray
uimage2DMSGL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLETexture2DMultisample
uimage2DMSArrayGL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE_ARRAYTexture2DMultisampleArray

OpenGL ES 3.1 admite los siguientes tipos de imagen:

Tipo GLSLEnumeración de tipo OpenGLTipo de textura
image2DGL_IMAGE_2DTexture2D
image3DGL_IMAGE_3DTexture3D
imageCubeGL_IMAGE_CUBETextureCubeMap
imagen2DArrayGL_IMAGE_2D_ARRAYTexture2DArray
iimage2DGL_INT_IMAGE_2DTexture2D
iimage3DGL_INT_IMAGE_3DTexture3D
iimageCubeGL_INT_IMAGE_CUBETextureCubeMap
iimage2DArrayGL_INT_IMAGE_2D_ARRAYTexture2DArray
uimage2DGL_UNSIGNED_INT_IMAGE_2DTexture2D
uimage3DGL_UNSIGNED_INT_IMAGE_3DTexture3D
uimageCubeGL_UNSIGNED_INT_IMAGE_CUBETextureCubeMap
uimage2DArrayGL_UNSIGNED_INT_IMAGE_2D_ARRAYTexture2DArray

OpenGL ES 3.2 es compatible con todos los tipos de imagen de OpenGL ES 3.1, además de los siguientes:

Tipo GLSLEnumeración de tipo de OpenGLTipo de textura
imageBufferGL_IMAGE_BUFFERTextureBuffer
imageCubeArrayGL_IMAGE_CUBE_MAP_ARRAYTextureCubeMapArray
iimageBufferGL_IMAGE_BUFFERTextureBuffer
iimageCubeArrayGL_INT_IMAGE_CUBE_MAP_ARRAYTextureCubeMapArray
uimageBufferGL_UNSIGNED_INT_IMAGE_BUFFERTextureBuffer
uimageCubeArrayGL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAYTextureCubeMapArray

El uso previsto sería similar a:

import Qt3D.Render 2.14

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

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

Documentación de la propiedad

access : enumeration

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

ConstanteDescripción
ShaderImage.ReadOnlyAcceso de solo lectura.
ShaderImage.WriteOnlyAcceso de solo escritura.
ShaderImage.ReadWriteAcceso de lectura y escritura.

El valor por defecto es ShaderImage.ReadWrite.

format : enumeration

Especifica el formato de imagen, lo cual es fundamental a la hora de almacenar valores en el « ShaderImage » desde un shader.

El formato no tiene por qué ser el mismo que el de la textura a la que se hace referencia. Sin embargo, debe ser compatible (debe coincidir en tamaño, aunque no necesariamente en tipo de clase). Por ejemplo, una textura de formato R32F (tamaño 32 bits, clase 1x32) podría utilizarse con una imagen de formato RGBA8I (tamaño 32 bits, clase 4x8). La tabla 8.27 de las especificaciones de OpenGL muestra el tamaño y la clase de todos los formatos de imagen compatibles.

Por defecto, Qt3D intentará establecer el formato de la imagen para que coincida con el de la textura a la que se hace referencia.

El valor por defecto es ` ShaderImage.Automatic`.

layer : int

Determina qué capa de la textura a la que se hace referencia debe utilizarse para el « ShaderImage ». Esta propiedad no tiene ningún efecto si « layered » está establecido en «true» o si el tipo de la textura de referencia no es compatible con las capas.

Nota: Cuando la textura a la que se hace referencia es de tipo «cube map» o «cube map array» y la opción « ĺayered » está establecida en «false», la cara y la capa se recuperan de la siguiente manera:

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

El valor por defecto es 0.

layered : bool

*

Si se establece en «true», y la textura a la que se hace referencia es una matriz unidimensional, bidimensional o tridimensional, un mapa cúbico, una matriz de mapas cúbicos o una textura de matriz bidimensional con muestreo múltiple, se vinculará todo el nivel para todas las capas. Si se establece en «false», solo se vinculará la capa única especificada por la propiedad layer.

El valor por defecto es ` false`.

mipLevel : int

Indica qué «mipLevel» de la textura a la que se hace referencia debe utilizarse para el « ShaderImage ».

El valor por defecto es 0.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.