En esta página

QRhiReadbackDescription Class

Describe una operación de lectura (lectura del contenido de una textura desde una memoria que podría ser exclusiva de la GPU). 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

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 lectura es un objeto ` QRhiTexture ` o el búfer de fondo actual del ` QRhiSwapChain` seleccionado. Cuando no se ha establecido ` texture()`, se utiliza la cadena de intercambio. En caso contrario, el ` QRhiTexture ` especificado se trata como el origen.

Nota: Las texturas utilizadas en las lecturas posteriores deben crearse con QRhiTexture::UsedAsTransferSource.

Nota: Las cadenas de intercambio utilizadas en las lecturas deben crearse con ` QRhiSwapChain::UsedAsTransferSource`.

layer() y level() solo son aplicables cuando la fuente es un QRhiTexture.

Nota: Las texturasmultisample no se pueden leer de nuevo. No obstante, las lecturas de retorno sí son compatibles con los búferes de swapchain multisample.

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 miembro

[constexpr noexcept default] QRhiReadbackDescription::QRhiReadbackDescription()

Crea una descripción de lectura de textura vacía.

Nota: La textura de origen se establece en nulo por defecto, lo que sigue siendo una lectura válida: especifica que se debe leer el búfer de fondo de la cadena de intercambio actual. (Por «actual» se entiende la cadena de intercambio de destino del fotograma en el momento de confirmar el « QRhiResourceUpdateBatch » con el « texture readback » en él).

QRhiReadbackDescription::QRhiReadbackDescription(QRhiTexture *texture)

Crea una descripción de lectura de textura que especifica que se debe leer el nivel 0 de la capa 0 de texture.

Nota: texture también puede ser nulo, 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 del cubemap, índice de la matriz). El valor por defecto es 0.

Solo es aplicable cuando la fuente de la lectura es un ` QRhiTexture`.

Véase también setLayer().

int QRhiReadbackDescription::level() const

Devuelve el nivel de mip establecido actualmente. El valor por defecto es 0.

Solo es aplicable cuando la fuente de la lectura es un ` QRhiTexture`.

Véase también setLevel().

[since 6.10] QRect QRhiReadbackDescription::rect() const

Devuelve el rectángulo que se va a leer. Por defecto, se trata de un rectángulo no válido.

Si no es válido, se vuelve a leer toda la textura o el búfer de fondo de la cadena de intercambio.

Esta función se introdujo en Qt 6.10.

Véase también ` setRect()`.

void QRhiReadbackDescription::setLayer(int layer)

Establece la matriz « layer » para su lectura posterior.

Véase también layer().

void QRhiReadbackDescription::setLevel(int level)

Establece el mip level e que se va a leer.

Véase también level().

[since 6.10] void QRhiReadbackDescription::setRect(const QRect &rectangle)

Establece el ` rectangle ` para la lectura posterior.

Esta función se introdujo en Qt 6.10.

Véase también rect().

void QRhiReadbackDescription::setTexture(QRhiTexture *tex)

Establece la textura tex como fuente de la operación de lectura.

También es válido establecer ` nullptr `; en ese caso, se utiliza el búfer de fondo actual de la cadena de intercambio (swapchain) actual. (Sin embargo, en ese caso, la operación de lectura no se puede ejecutar en un fotograma que no se base en una cadena de intercambio).

Nota: Las texturasmultisample no se pueden leer de nuevo. Sin embargo, las lecturas de retorno sí son compatibles con los búferes de swapchain multisample.

Nota: Las texturas utilizadas en las lecturas de retorno deben crearse con ` QRhiTexture::UsedAsTransferSource`.

Nota: Las cadenas de intercambio (swapchains) utilizadas en las lecturas de retorno deben crearse con ` QRhiSwapChain::UsedAsTransferSource`.

Véase también ` texture()`.

QRhiTexture *QRhiReadbackDescription::texture() const

Devuelve el objeto ` QRhiTexture ` que se lee. Se puede dejar establecido en ` nullptr `, lo que indica que, en su lugar, se debe utilizar el búfer de fondo de la cadena de intercambio actual.

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.