En esta página

Qt3DRender::QShaderImage Class

class Qt3DRender::QShaderImage

Proporciona acceso a Image desde los programas de sombreado. Más...

Encabezado: #include <qshaderimage.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: ShaderImage
Heredado de: Qt3DCore::QNode
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

enum Access { ReadOnly, WriteOnly, ReadWrite }
enum ImageFormat { NoFormat, Automatic, R8_UNorm, RG8_UNorm, RGBA8_UNorm, …, RGB10A2U }

Propiedades

Funciones públicas

Qt3DRender::QShaderImage::Access access() const
Qt3DRender::QShaderImage::ImageFormat format() const
int layer() const
bool layered() const
int mipLevel() const
Qt3DRender::QAbstractTexture *texture() const

Ranuras públicas

void setAccess(Qt3DRender::QShaderImage::Access access)
void setFormat(Qt3DRender::QShaderImage::ImageFormat format)
void setLayer(int layer)
void setLayered(bool layered)
void setMipLevel(int mipLevel)
void setTexture(Qt3DRender::QAbstractTexture *texture)

Señales

void accessChanged(Qt3DRender::QShaderImage::Access access)
void formatChanged(Qt3DRender::QShaderImage::ImageFormat format)
void layerChanged(int layer)
void layeredChanged(bool layered)
void mipLevelChanged(int mipLevel)
void textureChanged(Qt3DRender::QAbstractTexture *texture)

Descripción detallada

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

Para que QShaderImage funcione correctamente, debe asignarse como valor de un objeto ` QParameter` y hacer referencia a un ` Qt3DRender::QAbstractTexture ` 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 multimuestra bidimensional, es posible vincular bien todo el nivel de textura, bien una sola capa o cara de dicho nivel. Esto se puede controlar mediante la propiedad ` layered `.

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

OpenGL 4 admite los siguientes tipos de imagen:

Tipo GLSLEnumeración de tipo OpenGLTipo de textura
image1DGL_IMAGE_1DQTexture1D
imagen2DGL_IMAGE_2DQTexture2D
imagen3DGL_IMAGE_3DQTexture3D
imagen2DRectGL_IMAGE_2D_RECTQTextureRectangle
imageCubeGL_IMAGE_CUBEQTextureCubeMap
imageBufferGL_IMAGE_BUFFERQTextureBuffer
matriz1DdeimágenesGL_IMAGE_1D_ARRAYQTexture1DArray
matriz2DdeimágenesGL_IMAGE_2D_ARRAYQTexture2DArray
matriz de imagen cúbicaGL_IMAGE_CUBE_MAP_ARRAYQTextureCubeMapArray
image2DMSGL_IMAGE_2D_MULTISAMPLEQTexture2DMultisample
image2DMSArrayGL_IMAGE_2D_MULTISAMPLE_ARRAYQTexture2DMultisampleArray
iimage1DGL_INT_IMAGE_1DQTexture1D
iimage2DGL_INT_IMAGE_2DQTexture2D
iimage3DGL_INT_IMAGE_3DQTexture3D
iimage2DRectGL_INT_IMAGE_2D_RECTQTextureRectangle
iimageCubeGL_INT_IMAGE_CUBEQTextureCubeMap
iimageBufferGL_INT_IMAGE_BUFFERQTextureBuffer
iimage1DArrayGL_INT_IMAGE_1D_ARRAYQTexture1DArray
iimage2DArrayGL_INT_IMAGE_2D_ARRAYQTexture2DArray
iimageCubeArrayGL_INT_IMAGE_CUBE_MAP_ARRAYQTextureCubeMapArray
iimage2DMSGL_INT_IMAGE_2D_MULTISAMPLEQTexture2DMultisample
iimage2DMSArrayGL_INT_IMAGE_2D_MULTISAMPLE_ARRAYQTexture2DMultisampleArray
uimage1DGL_UNSIGNED_INT_IMAGE_1DQTexture1D
uimage2DGL_UNSIGNED_INT_IMAGE_2DQTexture2D
uimage3DGL_UNSIGNED_INT_IMAGE_3DQTexture3D
uimage2DRectGL_UNSIGNED_INT_IMAGE_2D_RECTQTextureRectangle
uimageCubeGL_UNSIGNED_INT_IMAGE_CUBEQTextureCubeMap
uimageBufferGL_UNSIGNED_INT_IMAGE_BUFFERQTextureBuffer
uimage1DArrayGL_UNSIGNED_INT_IMAGE_1D_ARRAYQTexture1DArray
uimage2DArrayGL_UNSIGNED_INT_IMAGE_2D_ARRAYQTexture2DArray
uimageCubeArrayGL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAYQTextureCubeMapArray
uimage2DMSGL_UNSIGNED_INT_IMAGE_2D_MULTIMUESTREOQTexture2DMultisample
uimage2DMSArrayGL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE_ARRAYQTexture2DMultisampleArray

OpenGL ES 3.1 admite los siguientes tipos de imagen:

Tipo GLSLEnumeración de tipo OpenGLTipo de textura
image2DGL_IMAGE_2DQTexture2D
image3DGL_IMAGE_3DQTexture3D
imageCubeGL_IMAGE_CUBEQTextureCubeMap
imagen2DArrayGL_IMAGE_2D_ARRAYQTexture2DArray
iimage2DGL_INT_IMAGE_2DQTexture2D
iimage3DGL_INT_IMAGE_3DQTexture3D
iimageCubeGL_INT_IMAGE_CUBEQTextureCubeMap
iimage2DArrayGL_INT_IMAGE_2D_ARRAYQTexture2DArray
uimage2DGL_UNSIGNED_INT_IMAGE_2DQTexture2D
uimage3DGL_UNSIGNED_INT_IMAGE_3DQTexture3D
uimageCubeGL_UNSIGNED_INT_IMAGE_CUBEQTextureCubeMap
uimage2DArrayGL_UNSIGNED_INT_IMAGE_2D_ARRAYQTexture2DArray

OpenGL ES 3.2 es compatible con todos los tipos de imagen de OpenGL ES 3.1, así como con los siguientes:

Tipo GLSLEnumeración de tipo de OpenGLTipo de textura
imageBufferGL_IMAGE_BUFFERQTextureBuffer
imageCubeArrayGL_IMAGE_CUBE_MAP_ARRAYQTextureCubeMapArray
iimageBufferGL_IMAGE_BUFFERQTextureBuffer
iimageCubeArrayGL_INT_IMAGE_CUBE_MAP_ARRAYQTextureCubeMapArray
uimageBufferGL_UNSIGNED_INT_IMAGE_BUFFERQTextureBuffer
uimageCubeArrayGL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAYQTextureCubeMapArray

El uso previsto sería similar al siguiente:

Qt3DRender::QTexture2D *tex2D = new Qt3DRender::QTexture2D();
...
Qt3DRender::QMaterial *material = new Qt3DRender::QMaterial();
...
Qt3DRender::QParameter *imageParameter = new Qt3DRender::QParameter();
Qt3DRender::QShaderImage *shaderImage = new Qt3DRender::QShaderImage();

shaderImage->setTexture(tex2D);

imageParameter->setName("imageUniformName");
imageParameter->setValue(QVariant::fromValue(shaderImage));

material->addParameter(imageParamenter);

Documentación sobre los tipos de miembro

enum QShaderImage::Access

ConstanteValorDescripción
Qt3DRender::QShaderImage::ReadOnly0La imagen solo se leerá desde los shaders
Qt3DRender::QShaderImage::WriteOnly1Solo se escribirá en la imagen desde los shaders
Qt3DRender::QShaderImage::ReadWrite2La imagen solo se leerá y se escribirá desde los shaders

enum QShaderImage::ImageFormat

Esta lista recoge todos los formatos de imagen posibles

ConstanteValorDescripción
Qt3DRender::QShaderImage::NoFormat0GL_NONE
Qt3DRender::QShaderImage::Automatic1Qt 3D intentará determinar el formato automáticamente basándose en la textura a la que se hace referencia.
Qt3DRender::QShaderImage::R8_UNorm0x8229GL_R8 (tipo GLSL r8, compatible con OpenGL 4.2 y versiones posteriores)
Qt3DRender::QShaderImage::RG8_UNorm0x822BGL_RG8 (tipo GLSL rg8, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA8_UNorm0x8058GL_RGBA8 (tipo GLSL rgba8, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R16_UNorm0x822AGL_R16 (tipo GLSL r16, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG16_UNorm0x822CGL_RG16 (tipo GLSL rg16, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA16_UNorm0x805BGL_RGBA16 (tipo GLSL rgba16, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::R8_SNorm0x8F94GL_R8_SNORM (tipo GLSL r8_snorm, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG8_SNorm0x8F95GL_RG8_SNORM (tipo GLSL rg8_snorm, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA8_SNorm0x8F97GL_RGBA8_SNORM (tipo GLSL rgba8_snorm, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R16_SNorm0x8F98GL_R16_SNORM (tipo GLSL r16_snorm, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG16_SNorm0x8F99GL_RG16_SNORM (tipo GLSL rg16_snorm, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA16_SNorm0x8F9BGL_RGBA16_SNORM (tipo GLSL rgba16_snorm, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::R8U0x8232GL_R8UI (tipo GLSL r8ui, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG8U0x8238GL_RG8UI (tipo GLSL rg8ui, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA8U0x8D7CGL_RGBA8UI (tipo GLSL rgba8ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R16U0x8234GL_R16UI (tipo GLSL r16ui, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG16U0x823AGL_RG16UI (tipo GLSL rg16ui, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA16U0x8D76GL_RGBA16UI (tipo GLSL rgba16ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R32U0x8236GL_R32UI (tipo GLSL r32ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1)
Qt3DRender::QShaderImage::RG32U0x823CGL_RG32UI (tipo GLSL rg32ui, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA32U0x8D70GL_RGBA32UI (tipo GLSL rgba32ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R8I0x8231GL_R8I (tipo GLSL r8i, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG8I0x8237GL_RG8I (tipo GLSL rg8i, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA8I0x8D8EGL_RGBA8I (tipo GLSL rgba8i, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R16I0x8233GL_R16I (tipo GLSL r16i, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG16I0x8239GL_RG16I (tipo GLSL rg16i, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA16I0x8D88GL_RGBA16I (tipo GLSL rgba16i, compatible con OpenGL 4.2+ y OpenGL ES 3.1)
Qt3DRender::QShaderImage::R32I0x8235GL_R32I (tipo GLSL r32i, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::RG32I0x823BGL_RG32I (tipo GLSL rg32i, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA32I0x8D82GL_RGBA32I (tipo GLSL rgba32i, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R16F0x822DGL_R16F (tipo GLSL r16f, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RG16F0x822FGL_RG16F (tipo GLSL rg16f, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA16F0x881AGL_RGBA16F (tipo GLSL rgba16f, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::R32F0x822EGL_R32F (tipo GLSL r32f, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::RG32F0x8230GL_RG32F (tipo GLSL rg32f, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGBA32F0x8814GL_RGBA32F (tipo GLSL rgba32f, compatible con OpenGL 4.2+ y OpenGL ES 3.1+)
Qt3DRender::QShaderImage::RG11B10F0x8C3AGL_R11F_G11F_B10F (tipo GLSL r11f_g11f_b10f, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGB10A20x8059GL_RGB10_A2 (tipo GLSL rgb10_a2, compatible con OpenGL 4.2+)
Qt3DRender::QShaderImage::RGB10A2U0x906FGL_RGB10_A2UI (tipo GLSL rgb10_a2ui, compatible con OpenGL 4.2+)

Documentación de propiedades

access : Access

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 sea incompatible, el comportamiento es indefinido.

El valor por defecto es « QShaderImage::ReadWrite ».

Funciones de acceso:

Qt3DRender::QShaderImage::Access access() const
void setAccess(Qt3DRender::QShaderImage::Access access)

Señal del notificador:

void accessChanged(Qt3DRender::QShaderImage::Access access)

format : ImageFormat

Especifica el formato de imagen, lo cual es fundamental a la hora de almacenar valores en la imagen 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 con formato R32F (tamaño de 32 bits, clase 1x32) podría utilizarse con una imagen de formato RGBA8I (tamaño de 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 QShaderImage::Automatic.

Funciones de acceso:

Qt3DRender::QShaderImage::ImageFormat format() const
void setFormat(Qt3DRender::QShaderImage::ImageFormat format)

Señal del notificador:

void formatChanged(Qt3DRender::QShaderImage::ImageFormat format)

layer : int

Determina qué capa de la textura a la que se hace referencia debe utilizarse para el « QShaderImage ». 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 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.

Funciones de acceso:

int layer() const
void setLayer(int layer)

Señal de notificación:

void layerChanged(int layer)

layered : bool

*

Si se establece en «true», y la textura a la que se hace referencia es una matriz unidimensional, bidimensional, 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`.

Funciones de acceso:

bool layered() const
void setLayered(bool layered)

Señal de notificador:

void layeredChanged(bool layered)

mipLevel : int

Indica qué mipLevel de la textura a la que se hace referencia debe utilizarse para el ` QShaderImage`.

El valor por defecto es 0.

Funciones de acceso:

int mipLevel() const
void setMipLevel(int mipLevel)

Señal de notificador:

void mipLevelChanged(int mipLevel)

texture : Qt3DRender::QAbstractTexture*

Contiene la textura que utilizará la imagen del sombreador.

Funciones de acceso:

Qt3DRender::QAbstractTexture *texture() const
void setTexture(Qt3DRender::QAbstractTexture *texture)

Señal de notificación:

void textureChanged(Qt3DRender::QAbstractTexture *texture)

© 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.