QRhiShaderResourceBinding Class
Describe el recurso de sombreado para un único punto de enlace. Más información...
| Encabezado: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Desde: | Qt 6.6 |
Tipos públicos
| enum | StageFlag { VertexStage, TessellationControlStage, TessellationEvaluationStage, FragmentStage, ComputeStage, GeometryStage } |
| flags | StageFlags |
| enum | Type { UniformBuffer, SampledTexture, Texture, Sampler, ImageLoad, …, BufferLoadStore } |
Funciones públicas
| QRhiShaderResourceBinding() | |
| bool | isLayoutCompatible(const QRhiShaderResourceBinding &other) const |
Miembros públicos estáticos
| QRhiShaderResourceBinding | bufferLoad(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf) |
| QRhiShaderResourceBinding | bufferLoad(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size) |
| QRhiShaderResourceBinding | bufferLoadStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf) |
| QRhiShaderResourceBinding | bufferLoadStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size) |
| QRhiShaderResourceBinding | bufferStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf) |
| QRhiShaderResourceBinding | bufferStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size) |
| QRhiShaderResourceBinding | imageLoad(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, int level) |
| QRhiShaderResourceBinding | imageLoadStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, int level) |
| QRhiShaderResourceBinding | imageStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, int level) |
| QRhiShaderResourceBinding | sampledTexture(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, QRhiSampler *sampler) |
| QRhiShaderResourceBinding | sampledTextures(int binding, QRhiShaderResourceBinding::StageFlags stage, int count, const QRhiShaderResourceBinding::TextureAndSampler *texSamplers) |
| QRhiShaderResourceBinding | sampler(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiSampler *sampler) |
| QRhiShaderResourceBinding | texture(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex) |
| QRhiShaderResourceBinding | textures(int binding, QRhiShaderResourceBinding::StageFlags stage, int count, QRhiTexture **tex) |
| QRhiShaderResourceBinding | uniformBuffer(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf) |
| QRhiShaderResourceBinding | uniformBuffer(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size) |
| QRhiShaderResourceBinding | uniformBufferWithDynamicOffset(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 size) |
Elementos no miembros relacionados
| size_t | qHash(const QRhiShaderResourceBinding &key, size_t seed = 0) |
| bool | operator!=(const QRhiShaderResourceBinding &a, const QRhiShaderResourceBinding &b) |
| bool | operator==(const QRhiShaderResourceBinding &a, const QRhiShaderResourceBinding &b) |
Descripción detallada
No se puede crear directamente un objeto `QRhiShaderResourceBinding`. En su lugar, utiliza las funciones estáticas como ` uniformBuffer()` o ` sampledTexture()` para obtener una instancia.
Nota: Se trata de una API de RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.
Documentación sobre los tipos de miembros
enum QRhiShaderResourceBinding::StageFlag
flags QRhiShaderResourceBinding::StageFlags
Valores de indicador que señalan en qué etapas es visible el recurso del sombreador
| Constante | Valor | Descripción |
|---|---|---|
QRhiShaderResourceBinding::VertexStage | 1 << 0 | Fase de vértices |
QRhiShaderResourceBinding::TessellationControlStage | 1 << 1 | Etapa de control de teselación (sombreador de casco) |
QRhiShaderResourceBinding::TessellationEvaluationStage | 1 << 2 | Etapa de evaluación de la teselación (sombreador de dominio) |
QRhiShaderResourceBinding::FragmentStage | 1 << 4 | Etapa de fragmentos (sombreador de píxeles) |
QRhiShaderResourceBinding::ComputeStage | 1 << 5 | Etapa de cálculo |
QRhiShaderResourceBinding::GeometryStage | 1 << 3 | Etapa de geometría |
El tipo StageFlags es una definición de tipo (typedef) para QFlags<StageFlag>. Almacena una combinación OR de valores de StageFlag.
enum QRhiShaderResourceBinding::Type
Especifica el tipo del recurso de shader vinculado a un punto de enlace
| Constante | Valor | Descripción |
|---|---|---|
QRhiShaderResourceBinding::UniformBuffer | 0 | Búfer uniforme |
QRhiShaderResourceBinding::SampledTexture | 1 | Muestreador de imagen combinado (un par formado por una textura y un muestreador). Aunque el lenguaje de sombreado asociado a la API 3D subyacente no admita este concepto (por ejemplo, D3D y HLSL), sigue siendo compatible porque la capa de traducción del sombreador se encarga de la traducción y reasignación adecuadas de los puntos de enlace o registros del sombreador. |
QRhiShaderResourceBinding::Texture | 2 | Textura (separada) |
QRhiShaderResourceBinding::Sampler | 3 | Muestreador (separado) |
QRhiShaderResourceBinding::ImageLoad | 4 | Carga de imagen (con GLSL, esto equivale a llamar a ` imageLoad()` en un único nivel —y en una o en todas las capas— de una textura expuesta al sombreador como un objeto de imagen) |
QRhiShaderResourceBinding::ImageStore | 5 | Almacenamiento de imagen (con GLSL, esto equivale a llamar a ` imageStore()` o `imageAtomic*()` en un único nivel —y en una o en todas las capas— de una textura expuesta al sombreador como un objeto de imagen) |
QRhiShaderResourceBinding::ImageLoadStore | 6 | Carga y almacenamiento de imágenes |
QRhiShaderResourceBinding::BufferLoad | 7 | Carga del búfer de almacenamiento (en GLSL, esto equivale a leer desde un búfer de almacenamiento del sombreador) |
QRhiShaderResourceBinding::BufferStore | 8 | Almacenamiento en el búfer de almacenamiento (en GLSL, esto equivale a escribir en un búfer de almacenamiento del sombreador) |
QRhiShaderResourceBinding::BufferLoadStore | 9 | Carga y almacenamiento en el búfer de almacenamiento |
Documentación de las funciones miembro
[constexpr noexcept default] QRhiShaderResourceBinding::QRhiShaderResourceBinding()
Crea por defecto una instancia de ` QRhiShaderResourceBinding`.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::bufferLoad(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf)
Devuelve un enlace de recurso de shader para un búfer de almacenamiento de solo lectura con el número de binding y el pipeline stage indicados.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::StorageBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no se puede utilizar con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a disposición, cuyos recursos se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Solo se garantiza la disponibilidad de la carga/almacenamientoen búfer dentro de una canalización de cálculo. Aunque algunos backends pueden admitir el uso de estos recursos también en una canalización de gráficos, esto no es compatible de forma universal y, aun cuando lo sea, pueden surgir problemas inesperados en lo que respecta a las barreras y la sincronización. Por lo tanto, evita utilizar dichos recursos con shaders que no sean de cálculo.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::bufferLoad(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size)
Devuelve un enlace de recurso de shader para un búfer de almacenamiento de solo lectura con el número de binding y el pipeline stage indicados. Esta sobrecarga vincula únicamente una región, tal y como se especifica en offset y size.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::StorageBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no se puede utilizar con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear canalizaciones. Dicha canalización debe utilizarse siempre junto con otro QRhiShaderResourceBindings, compatible en cuanto a disposición, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Solo se garantiza la disponibilidad de la carga/almacenamientoen búfer dentro de una canalización de cálculo. Aunque algunos backends pueden admitir el uso de estos recursos también en una canalización gráfica, esto no es compatible de forma universal y, aun cuando lo sea, pueden surgir problemas inesperados en lo que respecta a las barreras y la sincronización. Por lo tanto, evita utilizar dichos recursos con shaders que no sean de cálculo.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::bufferLoadStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf)
Devuelve un enlace de recurso de shader para un búfer de almacenamiento de lectura y escritura con el número de binding y el pipeline stage indicados.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::StorageBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no puede utilizarse con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a disposición, cuyos recursos se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Solo se garantiza la disponibilidad de la carga/almacenamientoen búfer dentro de una canalización de cálculo. Aunque algunos backends pueden admitir el uso de estos recursos también en una canalización gráfica, esto no es compatible de forma universal y, aun cuando lo sea, pueden surgir problemas inesperados en lo que respecta a las barreras y la sincronización. Por lo tanto, evita utilizar dichos recursos con shaders que no sean de cálculo.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::bufferLoadStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size)
Devuelve un enlace de recurso de shader para un búfer de almacenamiento de lectura y escritura con el número de « binding » y la canalización « stage » indicados. Esta sobrecarga vincula únicamente una región, tal y como se especifica en « offset » y « size ».
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::StorageBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no puede utilizarse con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a diseño, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Solo se garantiza la disponibilidad de la carga/almacenamientoen búfer dentro de una canalización de cálculo. Aunque algunos backends pueden admitir el uso de estos recursos también en una canalización gráfica, esto no es compatible de forma universal y, aun cuando lo sea, pueden surgir problemas inesperados en lo que respecta a las barreras y la sincronización. Por lo tanto, evita utilizar dichos recursos con shaders que no sean de cálculo.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::bufferStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf)
Devuelve un enlace de recurso de shader para un búfer de almacenamiento de solo escritura con el número de binding y la canalización stage indicados.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::StorageBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no se puede utilizar con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a disposición, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Solo se garantiza la disponibilidad de la carga/almacenamientoen búfer dentro de una canalización de cálculo. Aunque algunos backends pueden admitir el uso de estos recursos también en una canalización gráfica, esto no es compatible de forma universal y, aun cuando lo sea, pueden surgir problemas inesperados en lo que respecta a las barreras y la sincronización. Por lo tanto, evita utilizar dichos recursos con shaders que no sean de cálculo.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::bufferStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size)
Devuelve un enlace de recurso de sombreador para un búfer de almacenamiento de solo escritura con el número de binding y el pipeline stage indicados. Esta sobrecarga enlaza únicamente una región, tal y como se especifica en offset y size.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::StorageBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no puede utilizarse con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear canalizaciones. Dicha canalización debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a disposición, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Solo se garantiza la disponibilidad de la carga y el almacenamientoen búfer dentro de un canal de computación. Aunque algunos backends pueden admitir el uso de estos recursos también en un canal de gráficos, esto no es compatible de forma universal y, aun cuando lo sea, pueden surgir problemas inesperados en lo que respecta a las barreras y la sincronización. Por lo tanto, evita utilizar dichos recursos con shaders que no sean de computación.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::imageLoad(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, int level)
Devuelve un enlace de recurso de shader para una imagen de almacenamiento de solo lectura con el número de binding y el pipeline stage indicados. Las operaciones de carga de la imagen tendrán acceso a todas las capas del level especificado. (Por lo tanto, si la textura es un cubemap, el shader debe utilizar imageCube en lugar de image2D)
Nota: Cuando tex no es nulo, debe haberse creado con QRhiTexture::UsedWithLoadStore.
Nota: tex puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no se puede utilizar con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible con el diseño y con recursos presentes, que se pase a QRhiCommandBuffer::setShaderResources().
Nota: La carga y el almacenamientode imágenes solo están disponibles en las etapas de cálculo y de fragmentos.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::imageLoadStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, int level)
Devuelve un enlace de recurso de shader para una imagen de almacenamiento de lectura/escritura con el número de « binding » y el «pipeline» stage especificados. Las operaciones de carga/almacenamiento de la imagen tendrán acceso a todas las capas del « level » especificado. (Por lo tanto, si la textura es un cubemap, el shader debe utilizar «imageCube» en lugar de «image2D»).
Nota: Cuando tex no es nulo, debe haberse creado con QRhiTexture::UsedWithLoadStore.
Nota: tex puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no puede utilizarse con QRhiCommandBuffer::setShaderResources(). Sin embargo, resulta adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a diseño, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: La carga y el almacenamientode imágenes solo están disponibles en las etapas de cálculo y de fragmentos.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::imageStore(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, int level)
Devuelve un enlace de recurso de shader para una imagen de almacenamiento de solo escritura con el número de binding y el pipeline stage indicados. Las operaciones de almacenamiento de imágenes tendrán acceso a todas las capas del level especificado. (Por lo tanto, si la textura es un cubemap, el shader debe utilizar imageCube en lugar de image2D)
Nota: Cuando tex no es nulo, debe haberse creado con QRhiTexture::UsedWithLoadStore.
Nota: tex puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no se puede utilizar con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible con el diseño, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: La carga y el almacenamientode imágenes solo están disponibles en las etapas de cálculo y de fragmentos.
bool QRhiShaderResourceBinding::isLayoutCompatible(const QRhiShaderResourceBinding &other) const
Devuelve ` true ` si el diseño es compatible con ` other`. El diseño no incluye el recurso propiamente dicho (como un búfer o una textura) ni los parámetros relacionados (como el desplazamiento o el tamaño).
Por ejemplo, los siguientes valores « a » y « b » no son iguales, pero son compatibles en cuanto a la disposición:
auto a = QRhiShaderResourceBinding::uniformBuffer(0, QRhiShaderResourceBinding::VertexStage, buffer);
auto b = QRhiShaderResourceBinding::uniformBuffer(0, QRhiShaderResourceBinding::VertexStage, someOtherBuffer, 256);[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::sampledTexture(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex, QRhiSampler *sampler)
Devuelve un enlace de recurso de shader para el número de enlace, las etapas del pipeline, la textura y el muestreador indicados por binding, stage, tex y sampler.
Nota: Esta función equivale a llamar a ` sampledTextures()` con un ` count ` igual a 1.
Nota: tex y sampler pueden ser nulos. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no se puede utilizar con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear pipelines. Dicho pipeline debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a diseño, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Es posible queun sombreador no pueda utilizar más de 16 texturas o muestreadores, dependiendo de la API gráfica subyacente. Este límite estricto debe tenerse en cuenta en el diseño del renderizador. Esto no se aplica a las matrices de texturas, que consumen un único punto de enlace (registro de sombreador) y pueden contener entre 256 y 2048 texturas, dependiendo de la API gráfica subyacente. Sin embargo, las matrices de texturas (véase sampledTextures()) no difieren en este aspecto del uso del mismo número de texturas individuales.
Véase también sampledTextures().
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::sampledTextures(int binding, QRhiShaderResourceBinding::StageFlags stage, int count, const QRhiShaderResourceBinding::TextureAndSampler *texSamplers)
Devuelve un enlace de recurso de shader para el número de enlace indicado, las etapas de la canalización y la matriz de pares de muestreadores de textura especificados por binding, stage, count y texSamplers.
Nota: count debe ser como mínimo 1 y no superior a 16.
Nota: Cuando count es 1, esta función es equivalente a sampledTexture().
Esta función es relevante cuando se trata de matrices de muestreadores de imagen combinados. Por ejemplo, en GLSL, ` layout(binding = 5) uniform sampler2D shadowMaps[8]; ` declara una matriz de muestreadores de imagen combinados. Se espera entonces que la aplicación proporcione un ` QRhiShaderResourceBinding ` para el punto de enlace 5, configurado llamando a esta función con ` count ` establecido en 8 y una textura y un muestreador válidos para cada elemento de la matriz.
Advertencia: Deben especificarsetodos los elementos de la matriz. En el ejemplo anterior, el único enfoque válido y portátil consiste en llamar a esta función con un count de 8. Además, todas las instancias de QRhiTexture y QRhiSampler deben ser válidas, lo que significa que nullptr no es un valor aceptado. Esto se debe a que algunas de las API subyacentes, como Vulkan, requieren un objeto de imagen y un objeto de muestreador válidos para cada elemento de las matrices de descriptores. Se recomienda a las aplicaciones que proporcionen muestreadores y texturas «ficticios» si algunos elementos de la matriz no son relevantes (por no ser accedidos en el shader).
Nota: ` texSamplers ` puede ser nulo. Es válido crear un ` QRhiShaderResourceBindings ` con recursos no especificados, pero dicho objeto no se puede utilizar con ` QRhiCommandBuffer::setShaderResources()`. Sin embargo, es adecuado para crear tuberías. Dicha tubería debe utilizarse siempre junto con otro ` QRhiShaderResourceBindings ` compatible en cuanto a diseño y con recursos presentes, que se pase a ` QRhiCommandBuffer::setShaderResources()`.
Véase también sampledTexture().
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::sampler(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiSampler *sampler)
Devuelve un enlace de recurso de shader para el número de enlace, las etapas de la canalización y el muestreador especificados mediante binding, stage y sampler.
Nota: ` sampler ` puede ser nulo. Es válido crear un ` QRhiShaderResourceBindings ` con recursos no especificados, pero dicho objeto no se puede utilizar con ` QRhiCommandBuffer::setShaderResources()`. Sin embargo, es adecuado para crear tuberías. Dicha tubería debe utilizarse siempre junto con otro ` QRhiShaderResourceBindings ` compatible en cuanto a disposición, cuyos recursos se pasen a ` QRhiCommandBuffer::setShaderResources()`.
No se admiten matrices de muestreadores independientes.
Esto crea un enlace para un objeto muestreador independiente, mientras que sampledTexture() es adecuado para muestreadores de imagen combinados. En el código GLSL compatible con Vulkan, los muestreadores independientes se declaran como sampler, a diferencia de sampler2D: layout(binding = 2) uniform sampler samp;
Cuando están presentes tanto un ` texture2D ` como un ` sampler `, pueden utilizarse conjuntamente para muestrear la textura: ` fragColor = texture(sampler2D(tex, samp), texcoord);`.
Nota: Es posible queun sombreador no pueda utilizar más de 16 muestreadores, dependiendo de la API gráfica subyacente. Este límite estricto debe tenerse en cuenta en el diseño del renderizador.
Véase también texture().
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::texture(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiTexture *tex)
Devuelve un enlace de recurso de shader para el número de enlace, las etapas de la canalización y la textura especificados mediante binding, stage y tex.
Nota: Esta función equivale a llamar a textures() con un count de 1.
Nota: ` tex ` puede ser nulo. Es válido crear un ` QRhiShaderResourceBindings ` con recursos no especificados, pero dicho objeto no se puede utilizar con ` QRhiCommandBuffer::setShaderResources()`. Sin embargo, es adecuado para crear tuberías (pipelines). Dicha tubería debe utilizarse siempre junto con otro ` QRhiShaderResourceBindings ` compatible en cuanto a disposición y con recursos presentes, pasado a ` QRhiCommandBuffer::setShaderResources()`.
Esto crea un enlace para un objeto de textura (imagen) independiente, mientras que sampledTexture() es adecuado para muestreadores de imágenes combinados. En el código GLSL compatible con Vulkan, las texturas independientes se declaran como texture2D, a diferencia de sampler2D: layout(binding = 1) uniform texture2D tex;
Nota: Es posible queun shader no pueda utilizar más de 16 texturas, dependiendo de la API gráfica subyacente. Este límite estricto debe tenerse en cuenta en el diseño del renderizador. Esto no se aplica a las matrices de texturas, que consumen un único punto de enlace (registro de sombreador) y pueden contener entre 256 y 2048 texturas, dependiendo de la API gráfica subyacente. Sin embargo, las matrices de texturas (véase sampledTextures()) no difieren en este aspecto del uso del mismo número de texturas individuales.
Véase también textures() y sampler().
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::textures(int binding, QRhiShaderResourceBinding::StageFlags stage, int count, QRhiTexture **tex)
Devuelve un enlace de recurso de shader para el número de enlace indicado, las etapas del pipeline y la matriz de texturas (independientes) especificadas por binding, stage, count y tex.
Nota: count debe ser al menos 1 y no superar 16.
Nota: Cuando count es 1, esta función es equivalente a texture().
Advertencia: Deben especificarsetodos los elementos de la matriz.
Nota: tex puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no se puede utilizar con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear tuberías. Dicha tubería debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a diseño, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Véase también texture() y sampler().
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::uniformBuffer(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf)
Devuelve un enlace de recurso de shader para el número de enlace, las etapas del pipeline y el búfer especificados mediante binding, stage y buf, respectivamente.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::UniformBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no puede utilizarse con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear canalizaciones. Dicha canalización debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible en cuanto a diseño, cuyos recursos estén presentes y se pasen a QRhiCommandBuffer::setShaderResources().
Nota: Si el tamaño de buf supera el límite indicado para QRhi::MaxUniformBufferRange, pueden producirse errores inesperados.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::uniformBuffer(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 offset, quint32 size)
Devuelve un enlace de recurso de shader para el número de enlace, las etapas de la canalización y el búfer especificados mediante binding, stage y buf. Esta sobrecarga enlaza únicamente una región, tal y como se especifica en offset y size.
Nota: Es responsabilidad del usuario asegurarse de que el desplazamiento esté alineado con QRhi::ubufAlignment().
Nota: size debe ser mayor que 0.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::UniformBuffer.
Nota: ` buf ` puede ser nulo. Es válido crear un ` QRhiShaderResourceBindings ` con recursos no especificados, pero dicho objeto no se puede utilizar con ` QRhiCommandBuffer::setShaderResources()`. Sin embargo, es adecuado para crear tuberías. Dicha tubería debe utilizarse siempre junto con otro ` QRhiShaderResourceBindings ` compatible en cuanto a diseño y con recursos presentes, que se pase a ` QRhiCommandBuffer::setShaderResources()`.
Nota: Si size supera el límite indicado para QRhi::MaxUniformBufferRange, pueden producirse errores inesperados.
[static] QRhiShaderResourceBinding QRhiShaderResourceBinding::uniformBufferWithDynamicOffset(int binding, QRhiShaderResourceBinding::StageFlags stage, QRhiBuffer *buf, quint32 size)
Devuelve un enlace de recurso de shader para el número de enlace, las etapas de la canalización y el búfer especificados mediante binding, stage y buf. Se supone que el búfer uniforme tiene un desplazamiento dinámico. El desplazamiento dinámico se puede especificar en QRhiCommandBuffer::setShaderResources(), lo que permite utilizar valores de desplazamiento variables sin necesidad de crear nuevas vinculaciones para el búfer. El tamaño de la región vinculada viene determinado por size. Al igual que con los desplazamientos no dinámicos, offset + size no puede superar el tamaño de buf.
Nota: Cuando buf no es nulo, debe haberse creado con QRhiBuffer::UniformBuffer.
Nota: buf puede ser nulo. Es válido crear un QRhiShaderResourceBindings con recursos no especificados, pero dicho objeto no puede utilizarse con QRhiCommandBuffer::setShaderResources(). Sin embargo, es adecuado para crear tuberías. Dicha tubería debe utilizarse siempre junto con otro QRhiShaderResourceBindings compatible con el diseño y con recursos presentes, pasado a QRhiCommandBuffer::setShaderResources().
Nota: Si size supera el límite indicado para QRhi::MaxUniformBufferRange, pueden producirse errores inesperados.
Elementos no miembros relacionados
[noexcept] size_t qHash(const QRhiShaderResourceBinding &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
[noexcept] bool operator!=(const QRhiShaderResourceBinding &a, const QRhiShaderResourceBinding &b)
Devuelve « false » si todas las vinculaciones de los dos objetos « QRhiShaderResourceBinding » — a y b — son iguales; en caso contrario, devuelve « true ».
[noexcept] bool operator==(const QRhiShaderResourceBinding &a, const QRhiShaderResourceBinding &b)
Devuelve « true » si el contenido de los dos objetos « QRhiShaderResourceBinding » — a y b — es igual. Esto incluye también los recursos (buffer, textura) y los parámetros relacionados (offset, tamaño). Para comparar únicamente las estructuras (punto de enlace, etapa del pipeline, tipo de recurso), utiliza en su lugar « isLayoutCompatible()».
© 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.