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 GLSL | Enumeración de tipos de OpenGL | Tipo de textura |
|---|---|---|
| image1D | GL_IMAGE_1D | Texture1D |
| imagen2D | GL_IMAGE_2D | Texture2D |
| imagen3D | GL_IMAGE_3D | Texture3D |
| imagen2DRect | GL_IMAGE_2D_RECT | TextureRectangle |
| imageCube | GL_IMAGE_CUBE | TextureCubeMap |
| imageBuffer | GL_IMAGE_BUFFER | TextureBuffer |
| matriz1Ddeimágenes | GL_IMAGE_1D_ARRAY | Texture1DArray |
| matriz2Ddeimágenes | GL_IMAGE_2D_ARRAY | Texture2DArray |
| matriz de imagen cúbica | GL_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| image2DMS | GL_IMAGE_2D_MULTISAMPLE | Texture2DMultisample |
| image2DMSArray | GL_IMAGE_2D_MULTISAMPLE_ARRAY | Texture2DMultisampleArray |
| iimage1D | GL_INT_IMAGE_1D | Texture1D |
| iimage2D | GL_INT_IMAGE_2D | Texture2D |
| iimage3D | GL_INT_IMAGE_3D | Texture3D |
| iimage2DRect | GL_INT_IMAGE_2D_RECT | TextureRectangle |
| iimageCube | GL_INT_IMAGE_CUBE | TextureCubeMap |
| iimageBuffer | GL_INT_IMAGE_BUFFER | TextureBuffer |
| iimage1DArray | GL_INT_IMAGE_1D_ARRAY | Texture1DArray |
| iimage2DArray | GL_INT_IMAGE_2D_ARRAY | Texture2DArray |
| iimageCubeArray | GL_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| iimage2DMS | GL_INT_IMAGE_2D_MULTISAMPLE | Texture2DMultisample |
| iimage2DMSArray | GL_INT_IMAGE_2D_MULTISAMPLE_ARRAY | Texture2DMultisampleArray |
| uimage1D | GL_UNSIGNED_INT_IMAGE_1D | Texture1D |
| uimage2D | GL_UNSIGNED_INT_IMAGE_2D | Texture2D |
| uimage3D | GL_UNSIGNED_INT_IMAGE_3D | Texture3D |
| uimage2DRect | GL_UNSIGNED_INT_IMAGE_2D_RECT | TextureRectangle |
| uimageCube | GL_UNSIGNED_INT_IMAGE_CUBE | TextureCubeMap |
| uimageBuffer | GL_UNSIGNED_INT_IMAGE_BUFFER | TextureBuffer |
| uimage1DArray | GL_UNSIGNED_INT_IMAGE_1D_ARRAY | Texture1DArray |
| uimage2DArray | GL_UNSIGNED_INT_IMAGE_2D_ARRAY | Texture2DArray |
| uimageCubeArray | GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| uimage2DMS | GL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE | Texture2DMultisample |
| uimage2DMSArray | GL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE_ARRAY | Texture2DMultisampleArray |
OpenGL ES 3.1 admite los siguientes tipos de imagen:
| Tipo GLSL | Enumeración de tipo OpenGL | Tipo de textura |
|---|---|---|
| image2D | GL_IMAGE_2D | Texture2D |
| image3D | GL_IMAGE_3D | Texture3D |
| imageCube | GL_IMAGE_CUBE | TextureCubeMap |
| imagen2DArray | GL_IMAGE_2D_ARRAY | Texture2DArray |
| iimage2D | GL_INT_IMAGE_2D | Texture2D |
| iimage3D | GL_INT_IMAGE_3D | Texture3D |
| iimageCube | GL_INT_IMAGE_CUBE | TextureCubeMap |
| iimage2DArray | GL_INT_IMAGE_2D_ARRAY | Texture2DArray |
| uimage2D | GL_UNSIGNED_INT_IMAGE_2D | Texture2D |
| uimage3D | GL_UNSIGNED_INT_IMAGE_3D | Texture3D |
| uimageCube | GL_UNSIGNED_INT_IMAGE_CUBE | TextureCubeMap |
| uimage2DArray | GL_UNSIGNED_INT_IMAGE_2D_ARRAY | Texture2DArray |
OpenGL ES 3.2 es compatible con todos los tipos de imagen de OpenGL ES 3.1, además de los siguientes:
| Tipo GLSL | Enumeración de tipo de OpenGL | Tipo de textura |
|---|---|---|
| imageBuffer | GL_IMAGE_BUFFER | TextureBuffer |
| imageCubeArray | GL_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| iimageBuffer | GL_IMAGE_BUFFER | TextureBuffer |
| iimageCubeArray | GL_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| uimageBuffer | GL_UNSIGNED_INT_IMAGE_BUFFER | TextureBuffer |
| uimageCubeArray | GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
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.
| Constante | Descripción |
|---|---|
ShaderImage.ReadOnly | Acceso de solo lectura. |
ShaderImage.WriteOnly | Acceso de solo escritura. |
ShaderImage.ReadWrite | Acceso 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.