En esta página

QRhiRenderPassDescriptor Class

Recurso de pasada de renderizado. 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

virtual bool isCompatible(const QRhiRenderPassDescriptor *other) const = 0
virtual const QRhiNativeHandles *nativeHandles()
virtual QRhiRenderPassDescriptor *newCompatibleRenderPassDescriptor() const = 0
virtual QVector<quint32> serializedFormat() const = 0

Funciones públicas reimplementadas

virtual QRhiResource::Type resourceType() const override

Descripción detallada

Una pasada de renderizado, si dicho concepto existe en la API gráfica subyacente, es una colección de adjuntos (color, profundidad, plantilla) y describe cómo se utilizan dichos adjuntos.

Nota: Se trata de una API RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.

Documentación de las funciones de miembro

[pure virtual] bool QRhiRenderPassDescriptor::isCompatible(const QRhiRenderPassDescriptor *other) const

Devuelve «true» si el other QRhiRenderPassDescriptor es compatible con este, lo que significa que this y other pueden utilizarse indistintamente en QRhiGraphicsPipeline::setRenderPassDescriptor().

El concepto de compatibilidad de los descriptores de renderpass es similar al de layout compatibility de las instancias de QRhiShaderResourceBindings. Permiten una mejor reutilización de las instancias de QRhiGraphicsPipeline: por ejemplo, se espera que una caché de instancias de QRhiGraphicsPipeline utilice estas funciones para buscar un pipeline coincidente, en lugar de limitarse a comparar punteros, lo que permite utilizar diferentes QRhiRenderPassDescriptor y QRhiShaderResourceBindings en combinación con el pipeline, siempre que sean compatibles.

Los detalles exactos de la compatibilidad dependen de la API gráfica subyacente. Dos descriptores de renderpass created procedentes del mismo QRhiTextureRenderTarget son siempre compatibles.

De forma similar a QRhiShaderResourceBindings, la compatibilidad también se puede comprobar sin necesidad de disponer de dos objetos existentes. Extraer el blob opaco llamando a ` serializedFormat()` permite comprobar la compatibilidad comparando el vector devuelto con el resultado de ` serializedFormat()` de otro ` QRhiRenderPassDescriptor`. Esto presenta ventajas en determinadas situaciones, ya que permite comprobar la compatibilidad de un ` QRhiRenderPassDescriptor ` con un ` QRhiGraphicsPipeline ` incluso cuando el ` QRhiRenderPassDescriptor ` con el que se construyó originalmente el pipeline ya no está disponible (pero los datos devueltos por su ` serializedFormat()` sí lo siguen estando).

Véanse también newCompatibleRenderPassDescriptor() y serializedFormat().

[virtual] const QRhiNativeHandles *QRhiRenderPassDescriptor::nativeHandles()

Devuelve un puntero a una subclase de ` QRhiNativeHandles ` específica del backend, como ` QRhiVulkanRenderPassNativeHandles`. El valor devuelto es ` nullptr ` cuando el backend no admite la exposición de los recursos nativos subyacentes.

Véase también QRhiVulkanRenderPassNativeHandles.

[pure virtual] QRhiRenderPassDescriptor *QRhiRenderPassDescriptor::newCompatibleRenderPassDescriptor() const

Devuelve un nuevo objeto ` QRhiRenderPassDescriptor ` que es un « compatible » con este.

Esta función permite clonar un ` QRhiRenderPassDescriptor`. El objeto devuelto está listo para ser utilizado, y la propiedad se transfiere al llamante. Clonar un objeto « QRhiRenderPassDescriptor » puede resultar útil en situaciones en las que el objeto se almacena en estructuras de datos relacionadas con los flujos de trabajo gráficos (para permitir la creación de nuevos flujos de trabajo, lo que a su vez requiere un objeto «renderpass descriptor»), y la vida útil del «renderpass descriptor» creado a partir de un «render target» puede ser más corta que la de los flujos de trabajo. (por ejemplo, porque el motor gestiona y destruye las pasadas de renderizado junto con las texturas y los objetivos de renderizado a partir de los cuales se crearon). En tal situación, puede resultar beneficioso almacenar una versión clonada en las estructuras de datos, transfiriendo así también la propiedad.

Véase también isCompatible().

[override virtual] QRhiResource::Type QRhiRenderPassDescriptor::resourceType() const

Reimplementa: QRhiResource::resourceType() const.

Devuelve el tipo de recurso.

[pure virtual] QVector<quint32> QRhiRenderPassDescriptor::serializedFormat() const

Devuelve un vector de números enteros que contiene un blob opaco que describe los datos relevantes para compatibility.

Dados dos objetos ` QRhiRenderPassDescriptor `, ` rp1 ` y ` rp2`, si los datos devueltos por esta función son idénticos, entonces se cumple que ` rp1->isCompatible(rp2)`, y viceversa.

Nota: Los datos devueltos están pensados para almacenarse en memoria y para realizar comparaciones durante el tiempo de vida del ` 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.

Nota: Se espera quela llamada a esta función sea una operación de bajo coste, ya que no se supone que los backends calculen los datos en esta función, sino que devuelvan una serie de datos ya calculados.

Al crear componentes reutilizables como parte de una biblioteca, en la que se crean y mantienen pipelines gráficos dirigidos a un « QRhiRenderTarget » (ya sea una «swapchain» o una textura) gestionado por el cliente de la biblioteca, los componentes deben ser capaces de gestionar un « QRhiRenderPassDescriptor » cambiante. Por ejemplo, porque el destino de renderizado cambia y, por lo tanto, invalida el QRhiRenderPassDescriptor anterior (al menos en lo que respecta al nuevo destino de renderizado), debido a que ahora puede tener un formato de color y unos archivos adjuntos diferentes. O porque variable rate shading se pone en uso de forma dinámica. Un patrón sencillo que ayuda a gestionar esto consiste en realizar la siguiente comprobación en cada fotograma, para detectar los casos en los que el pipeline debe asociarse a un nuevo QRhiRenderPassDescriptor, debido a que el destino de renderizado presenta ahora alguna diferencia con respecto a fotogramas anteriores:

QRhiRenderPassDescriptor *rp = m_renderTarget->renderPassDescriptor();
if (m_pipeline && rp->serializedFormat() != m_renderPassFormat) {
    m_pipeline->setRenderPassDescriptor(rp);
    m_renderPassFormat = rp->serializedFormat();
    m_pipeline->create();
}
// remember to store m_renderPassFormat also when creating m_pipeline the first time

Véase también isCompatible().

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