Qt3DRender::QShaderImage Class
class Qt3DRender::QShaderImageProporciona 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 GLSL | Enumeración de tipo OpenGL | Tipo de textura |
|---|---|---|
| image1D | GL_IMAGE_1D | QTexture1D |
| imagen2D | GL_IMAGE_2D | QTexture2D |
| imagen3D | GL_IMAGE_3D | QTexture3D |
| imagen2DRect | GL_IMAGE_2D_RECT | QTextureRectangle |
| imageCube | GL_IMAGE_CUBE | QTextureCubeMap |
| imageBuffer | GL_IMAGE_BUFFER | QTextureBuffer |
| matriz1Ddeimágenes | GL_IMAGE_1D_ARRAY | QTexture1DArray |
| matriz2Ddeimágenes | GL_IMAGE_2D_ARRAY | QTexture2DArray |
| matriz de imagen cúbica | GL_IMAGE_CUBE_MAP_ARRAY | QTextureCubeMapArray |
| image2DMS | GL_IMAGE_2D_MULTISAMPLE | QTexture2DMultisample |
| image2DMSArray | GL_IMAGE_2D_MULTISAMPLE_ARRAY | QTexture2DMultisampleArray |
| iimage1D | GL_INT_IMAGE_1D | QTexture1D |
| iimage2D | GL_INT_IMAGE_2D | QTexture2D |
| iimage3D | GL_INT_IMAGE_3D | QTexture3D |
| iimage2DRect | GL_INT_IMAGE_2D_RECT | QTextureRectangle |
| iimageCube | GL_INT_IMAGE_CUBE | QTextureCubeMap |
| iimageBuffer | GL_INT_IMAGE_BUFFER | QTextureBuffer |
| iimage1DArray | GL_INT_IMAGE_1D_ARRAY | QTexture1DArray |
| iimage2DArray | GL_INT_IMAGE_2D_ARRAY | QTexture2DArray |
| iimageCubeArray | GL_INT_IMAGE_CUBE_MAP_ARRAY | QTextureCubeMapArray |
| iimage2DMS | GL_INT_IMAGE_2D_MULTISAMPLE | QTexture2DMultisample |
| iimage2DMSArray | GL_INT_IMAGE_2D_MULTISAMPLE_ARRAY | QTexture2DMultisampleArray |
| uimage1D | GL_UNSIGNED_INT_IMAGE_1D | QTexture1D |
| uimage2D | GL_UNSIGNED_INT_IMAGE_2D | QTexture2D |
| uimage3D | GL_UNSIGNED_INT_IMAGE_3D | QTexture3D |
| uimage2DRect | GL_UNSIGNED_INT_IMAGE_2D_RECT | QTextureRectangle |
| uimageCube | GL_UNSIGNED_INT_IMAGE_CUBE | QTextureCubeMap |
| uimageBuffer | GL_UNSIGNED_INT_IMAGE_BUFFER | QTextureBuffer |
| uimage1DArray | GL_UNSIGNED_INT_IMAGE_1D_ARRAY | QTexture1DArray |
| uimage2DArray | GL_UNSIGNED_INT_IMAGE_2D_ARRAY | QTexture2DArray |
| uimageCubeArray | GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY | QTextureCubeMapArray |
| uimage2DMS | GL_UNSIGNED_INT_IMAGE_2D_MULTIMUESTREO | QTexture2DMultisample |
| uimage2DMSArray | GL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE_ARRAY | QTexture2DMultisampleArray |
OpenGL ES 3.1 admite los siguientes tipos de imagen:
| Tipo GLSL | Enumeración de tipo OpenGL | Tipo de textura |
|---|---|---|
| image2D | GL_IMAGE_2D | QTexture2D |
| image3D | GL_IMAGE_3D | QTexture3D |
| imageCube | GL_IMAGE_CUBE | QTextureCubeMap |
| imagen2DArray | GL_IMAGE_2D_ARRAY | QTexture2DArray |
| iimage2D | GL_INT_IMAGE_2D | QTexture2D |
| iimage3D | GL_INT_IMAGE_3D | QTexture3D |
| iimageCube | GL_INT_IMAGE_CUBE | QTextureCubeMap |
| iimage2DArray | GL_INT_IMAGE_2D_ARRAY | QTexture2DArray |
| uimage2D | GL_UNSIGNED_INT_IMAGE_2D | QTexture2D |
| uimage3D | GL_UNSIGNED_INT_IMAGE_3D | QTexture3D |
| uimageCube | GL_UNSIGNED_INT_IMAGE_CUBE | QTextureCubeMap |
| uimage2DArray | GL_UNSIGNED_INT_IMAGE_2D_ARRAY | QTexture2DArray |
OpenGL ES 3.2 es compatible con todos los tipos de imagen de OpenGL ES 3.1, así como con los siguientes:
| Tipo GLSL | Enumeración de tipo de OpenGL | Tipo de textura |
|---|---|---|
| imageBuffer | GL_IMAGE_BUFFER | QTextureBuffer |
| imageCubeArray | GL_IMAGE_CUBE_MAP_ARRAY | QTextureCubeMapArray |
| iimageBuffer | GL_IMAGE_BUFFER | QTextureBuffer |
| iimageCubeArray | GL_INT_IMAGE_CUBE_MAP_ARRAY | QTextureCubeMapArray |
| uimageBuffer | GL_UNSIGNED_INT_IMAGE_BUFFER | QTextureBuffer |
| uimageCubeArray | GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY | QTextureCubeMapArray |
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
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QShaderImage::ReadOnly | 0 | La imagen solo se leerá desde los shaders |
Qt3DRender::QShaderImage::WriteOnly | 1 | Solo se escribirá en la imagen desde los shaders |
Qt3DRender::QShaderImage::ReadWrite | 2 | La imagen solo se leerá y se escribirá desde los shaders |
enum QShaderImage::ImageFormat
Esta lista recoge todos los formatos de imagen posibles
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QShaderImage::NoFormat | 0 | GL_NONE |
Qt3DRender::QShaderImage::Automatic | 1 | Qt 3D intentará determinar el formato automáticamente basándose en la textura a la que se hace referencia. |
Qt3DRender::QShaderImage::R8_UNorm | 0x8229 | GL_R8 (tipo GLSL r8, compatible con OpenGL 4.2 y versiones posteriores) |
Qt3DRender::QShaderImage::RG8_UNorm | 0x822B | GL_RG8 (tipo GLSL rg8, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA8_UNorm | 0x8058 | GL_RGBA8 (tipo GLSL rgba8, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R16_UNorm | 0x822A | GL_R16 (tipo GLSL r16, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG16_UNorm | 0x822C | GL_RG16 (tipo GLSL rg16, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA16_UNorm | 0x805B | GL_RGBA16 (tipo GLSL rgba16, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::R8_SNorm | 0x8F94 | GL_R8_SNORM (tipo GLSL r8_snorm, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG8_SNorm | 0x8F95 | GL_RG8_SNORM (tipo GLSL rg8_snorm, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA8_SNorm | 0x8F97 | GL_RGBA8_SNORM (tipo GLSL rgba8_snorm, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R16_SNorm | 0x8F98 | GL_R16_SNORM (tipo GLSL r16_snorm, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG16_SNorm | 0x8F99 | GL_RG16_SNORM (tipo GLSL rg16_snorm, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA16_SNorm | 0x8F9B | GL_RGBA16_SNORM (tipo GLSL rgba16_snorm, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::R8U | 0x8232 | GL_R8UI (tipo GLSL r8ui, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG8U | 0x8238 | GL_RG8UI (tipo GLSL rg8ui, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA8U | 0x8D7C | GL_RGBA8UI (tipo GLSL rgba8ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R16U | 0x8234 | GL_R16UI (tipo GLSL r16ui, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG16U | 0x823A | GL_RG16UI (tipo GLSL rg16ui, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA16U | 0x8D76 | GL_RGBA16UI (tipo GLSL rgba16ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R32U | 0x8236 | GL_R32UI (tipo GLSL r32ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1) |
Qt3DRender::QShaderImage::RG32U | 0x823C | GL_RG32UI (tipo GLSL rg32ui, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA32U | 0x8D70 | GL_RGBA32UI (tipo GLSL rgba32ui, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R8I | 0x8231 | GL_R8I (tipo GLSL r8i, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG8I | 0x8237 | GL_RG8I (tipo GLSL rg8i, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA8I | 0x8D8E | GL_RGBA8I (tipo GLSL rgba8i, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R16I | 0x8233 | GL_R16I (tipo GLSL r16i, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG16I | 0x8239 | GL_RG16I (tipo GLSL rg16i, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA16I | 0x8D88 | GL_RGBA16I (tipo GLSL rgba16i, compatible con OpenGL 4.2+ y OpenGL ES 3.1) |
Qt3DRender::QShaderImage::R32I | 0x8235 | GL_R32I (tipo GLSL r32i, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::RG32I | 0x823B | GL_RG32I (tipo GLSL rg32i, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA32I | 0x8D82 | GL_RGBA32I (tipo GLSL rgba32i, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R16F | 0x822D | GL_R16F (tipo GLSL r16f, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RG16F | 0x822F | GL_RG16F (tipo GLSL rg16f, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA16F | 0x881A | GL_RGBA16F (tipo GLSL rgba16f, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::R32F | 0x822E | GL_R32F (tipo GLSL r32f, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::RG32F | 0x8230 | GL_RG32F (tipo GLSL rg32f, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGBA32F | 0x8814 | GL_RGBA32F (tipo GLSL rgba32f, compatible con OpenGL 4.2+ y OpenGL ES 3.1+) |
Qt3DRender::QShaderImage::RG11B10F | 0x8C3A | GL_R11F_G11F_B10F (tipo GLSL r11f_g11f_b10f, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGB10A2 | 0x8059 | GL_RGB10_A2 (tipo GLSL rgb10_a2, compatible con OpenGL 4.2+) |
Qt3DRender::QShaderImage::RGB10A2U | 0x906F | GL_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.