QRhiReadbackDescription Class
Describe una operación de readback (relectura del contenido de la textura desde una memoria posiblemente exclusiva de la GPU). Más...
| Cabecera: | #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 |
Funciones Públicas
| QRhiReadbackDescription() | |
| QRhiReadbackDescription(QRhiTexture *texture) | |
| int | layer() const |
| int | level() const |
(since 6.10) QRect | rect() const |
| void | setLayer(int layer) |
| void | setLevel(int level) |
(since 6.10) void | setRect(const QRect &rectangle) |
| void | setTexture(QRhiTexture *tex) |
| QRhiTexture * | texture() const |
Descripción detallada
El origen de la operación de readback es un QRhiTexture o el backbuffer actual del QRhiSwapChain actualmente apuntado. Si no se define texture(), se utiliza la cadena de intercambio. De lo contrario, el QRhiTexture especificado se trata como la fuente.
Nota: Las texturas utilizadas en readbacks deben crearse con QRhiTexture::UsedAsTransferSource.
Nota : Las cadenas de intercambio utilizadas en las readbacks deben crearse con QRhiSwapChain::UsedAsTransferSource.
layer() y level() sólo son aplicables cuando la fuente es QRhiTexture.
Nota : Las texturas multimuestra no se pueden volver a leer. Sin embargo, las devoluciones de lectura son compatibles con los buffers swapchain multimuestra.
Nota: Esta es una API RHI con garantías de compatibilidad limitadas, véase QRhi para más detalles.
Documentación de las funciones miembro
[constexpr noexcept] QRhiReadbackDescription::QRhiReadbackDescription()
Construye una descripción de lectura de textura vacía.
Nota: La textura de origen se establece en null por defecto, lo que sigue siendo una lectura válida: especifica que el backbuffer de la swapchain actual debe ser leído. (actual significa el swapchain de destino del fotograma en el momento de enviar el QRhiResourceUpdateBatch con el texture readback en él)
QRhiReadbackDescription::QRhiReadbackDescription(QRhiTexture *texture)
Construye una descripción de lectura de textura que especifica que se va a leer el nivel 0 de la capa 0 de texture.
Nota: texture también puede ser null, en cuyo caso este constructor es idéntico a la variante sin argumentos.
int QRhiReadbackDescription::layer() const
Devuelve la capa de matriz actualmente establecida (cara de cubemap, índice de matriz). Por defecto es 0.
Aplicable sólo cuando la fuente de la lectura es un QRhiTexture.
Véase también setLayer().
int QRhiReadbackDescription::level() const
Devuelve el nivel mip actual. El valor predeterminado es 0.
Aplicable sólo cuando la fuente de la lectura es QRhiTexture.
Véase también setLevel().
[since 6.10] QRect QRhiReadbackDescription::rect() const
Devuelve el rectángulo a leer. Por defecto es un rectángulo inválido.
Si es inválido, la textura entera o el backbuffer swapchain es leído de vuelta.
Esta función se introdujo en Qt 6.10.
Ver también setRect().
void QRhiReadbackDescription::setLayer(int layer)
Establece el array layer a leer.
Véase también layer().
void QRhiReadbackDescription::setLevel(int level)
Establece el mip level a leer.
Véase también level().
[since 6.10] void QRhiReadbackDescription::setRect(const QRect &rectangle)
Establece el rectangle a leer.
Esta función se introdujo en Qt 6.10.
Véase también rect().
void QRhiReadbackDescription::setTexture(QRhiTexture *tex)
Establece la textura tex como origen de la operación de lectura.
También es válido establecer nullptr, en cuyo caso se utiliza el backbuffer actual de la swapchain. (pero entonces la operación de readback no puede ser emitida en un frame no basado en swapchain)
Nota: Las texturas multimuestra no se pueden volver a leer. Sin embargo, las readbacks están soportadas para buffers swapchain multimuestra.
Nota : Las texturas utilizadas en las relecturas deben crearse con QRhiTexture::UsedAsTransferSource.
Nota : Las cadenas de intercambio utilizadas en las relecturas deben crearse con QRhiSwapChain::UsedAsTransferSource.
Véase también texture().
QRhiTexture *QRhiReadbackDescription::texture() const
Devuelve el QRhiTexture que se vuelve a leer. Puede dejarse establecido a nullptr que indica que el backbuffer de la swapchain actual debe ser usado en su lugar.
Véase también setTexture().
© 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.
