QRhiShaderResourceBindings Class
Incorpora recursos para que los shaders puedan acceder a los recursos de búfer, texturas y muestreadores. Más...
| 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 |
| Heredado de: | QRhiResource |
Funciones públicas
| const QRhiShaderResourceBinding * | bindingAt(qsizetype index) const |
| qsizetype | bindingCount() const |
| const QRhiShaderResourceBinding * | cbeginBindings() const |
| const QRhiShaderResourceBinding * | cendBindings() const |
| virtual bool | create() = 0 |
| bool | isLayoutCompatible(const QRhiShaderResourceBindings *other) const |
| QVector<quint32> | serializedLayoutDescription() const |
| void | setBindings(std::initializer_list<QRhiShaderResourceBinding> list) |
| void | setBindings(InputIterator first, InputIterator last) |
Funciones públicas reimplementadas
| virtual QRhiResource::Type | resourceType() const override |
Descripción detallada
Un QRhiShaderResourceBindings es una colección de objetos « QRhiShaderResourceBinding », cada uno de los cuales describe un único enlace.
Consideremos un sombreador de fragmentos con la siguiente interfaz:
layout(std140, binding = 0) uniform buf {
mat4 mvp;
int flip;
} ubuf;
layout(binding = 1) uniform sampler2D tex;Para que el sombreador pueda acceder a los recursos, se podrían crear los siguientes objetos `QRhiShaderResourceBindings` y, a continuación, pasarlos a ` QRhiGraphicsPipeline::setShaderResourceBindings()`:
QRhiShaderResourceBindings *srb = rhi->newShaderResourceBindings();
srb->setBindings({
QRhiShaderResourceBinding::uniformBuffer(0, QRhiShaderResourceBinding::VertexStage | QRhiShaderResourceBinding::FragmentStage, ubuf),
QRhiShaderResourceBinding::sampledTexture(1, QRhiShaderResourceBinding::FragmentStage, texture, sampler)
});
srb->create();
// ...
QRhiGraphicsPipeline *ps = rhi->newGraphicsPipeline();
// ...
ps->setShaderResourceBindings(srb);
ps->create();
// ...
cb->setGraphicsPipeline(ps);
cb->setShaderResources(); // binds srbEsto supone que ubuf es un QRhiBuffer, texture es un QRhiTexture, mientras que sampler es un QRhiSampler. El ejemplo también supone que el bloque «uniform» está presente en el sombreador de vértices, de modo que el mismo búfer también sea visible para la etapa de vértices.
Uso avanzado
Partiendo del ejemplo anterior, supongamos que ahora una pasada necesita utilizar exactamente el mismo pipeline y los mismos shaders con una textura diferente. Crear un « QRhiGraphicsPipeline » completamente independiente solo para esto sería excesivo. Por eso, la función QRhiCommandBuffer::setShaderResources() permite especificar un argumento « srb ». Siempre que las disposiciones (es decir, el número de enlaces y los puntos de enlace) coincidan entre dos QRhiShaderResourceBindings, ambos pueden utilizarse con el mismo pipeline, siempre que este se haya creado con uno de ellos en un primer momento. Consulte isLayoutCompatible() para obtener más detalles.
QRhiShaderResourceBindings *srb2 = rhi->newShaderResourceBindings();
// ...
cb->setGraphicsPipeline(ps);
cb->setShaderResources(srb2); // binds srb2Nota: Se trata de una API de RHI con garantías de compatibilidad limitadas; consulte QRhi para obtener más detalles.
Documentación de las funciones de miembro
const QRhiShaderResourceBinding *QRhiShaderResourceBindings::bindingAt(qsizetype index) const
Devuelve el enlace en la dirección especificada index.
qsizetype QRhiShaderResourceBindings::bindingCount() const
Devuelve el número de enlaces.
const QRhiShaderResourceBinding *QRhiShaderResourceBindings::cbeginBindings() const
Devuelve un iterador const que apunta al primer elemento de la lista de enlaces.
const QRhiShaderResourceBinding *QRhiShaderResourceBindings::cendBindings() const
Devuelve un iterador const que apunta justo después del último elemento de la lista de enlace.
[pure virtual] bool QRhiShaderResourceBindings::create()
Crea el conjunto de enlaces de recursos correspondiente. Dependiendo de la API gráfica subyacente, esto puede implicar la creación de recursos gráficos nativos, por lo que no debe darse por sentado que se trate de una operación de bajo coste.
Si se ha llamado previamente a create() sin el correspondiente destroy(), entonces se llama primero de forma implícita a destroy().
Devuelve ` true ` si se realiza correctamente, y ` false ` si falla. Independientemente del valor devuelto, llamar a ` destroy()` siempre es seguro.
bool QRhiShaderResourceBindings::isLayoutCompatible(const QRhiShaderResourceBindings *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). Sin embargo, sí incluye el punto de enlace, la etapa del canal y el tipo de recurso. Para que haya compatibilidad, el número y el orden de los enlaces también deben coincidir.
Cuando existe un ` QRhiGraphicsPipeline ` creado con este ` QRhiShaderResourceBindings`, y la función devuelve ` true`, ` other ` puede pasarse de forma segura a ` QRhiCommandBuffer::setShaderResources()`, y así utilizarse con el pipeline en lugar de este ` QRhiShaderResourceBindings`.
Nota: Esta función solo debe invocarse tras una llamada satisfactoria a ` create()`, ya que se basa en datos generados durante la preparación de las estructuras de datos subyacentes. De este modo, la función puede implementar un método de comparación más eficiente que iterar por dos listas de enlaces y llamar a ` QRhiShaderResourceBinding::isLayoutCompatible()` sobre cada par. Esto cobra especial relevancia cuando esta función se invoca con gran frecuencia.
Véase también ` serializedLayoutDescription()`.
[override virtual] QRhiResource::Type QRhiShaderResourceBindings::resourceType() const
Reimplementa: ` QRhiResource::resourceType()` const.
Devuelve el tipo de recurso.
QVector<quint32> QRhiShaderResourceBindings::serializedLayoutDescription() const
Devuelve un vector de números enteros que contiene un blob opaco que describe la estructura de la lista de enlaces, es decir, los datos relevantes para layout compatibility tests.
Dados dos objetos ` srb1 ` y ` srb2`, si los datos devueltos por esta función son idénticos, entonces se cumple que ` srb1->isLayoutCompatible(srb2)`, y viceversa.
Nota: Los datos devueltos están pensados para almacenarse en memoria y utilizarse en comparaciones durante el tiempo de vida de QRhi al que pertenece el objeto. No están pensados para almacenarse en disco, reutilizarse entre procesos ni utilizarse con múltiples instancias de QRhi con backends potencialmente diferentes.
Véase también isLayoutCompatible().
void QRhiShaderResourceBindings::setBindings(std::initializer_list<QRhiShaderResourceBinding> list)
Establece el valor de « list » de los enlaces.
template <typename InputIterator> void QRhiShaderResourceBindings::setBindings(InputIterator first, InputIterator last)
Establece la lista de enlaces a partir de los iteradores first y last.
© 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.