En esta página

QRhiRenderTarget Class

Representa un destino de renderizado en pantalla (swapchain) o fuera de pantalla (textura). 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
Heredado de: QRhiResource
Heredado por:

QRhiSwapChainRenderTarget y QRhiTextureRenderTarget

Funciones públicas

virtual float devicePixelRatio() const = 0
virtual QSize pixelSize() const = 0
QRhiRenderPassDescriptor *renderPassDescriptor() const
virtual int sampleCount() const = 0
void setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Descripción detallada

Las aplicaciones no crean una instancia de esta clase directamente. En su lugar, es la subclase QRhiTextureRenderTarget la que puede ser instanciada por los clientes de la API mediante newTextureRenderTarget(). La otra subclase es QRhiSwapChainRenderTarget, que es el tipo que devuelve QRhiSwapChain al llamar a currentFrameRenderTarget().

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

Véase también QRhiSwapChainRenderTarget y QRhiTextureRenderTarget.

Documentación de la función miembro

[pure virtual] float QRhiRenderTarget::devicePixelRatio() const

Devuelve la relación de píxeles del dispositivo. Para QRhiTextureRenderTarget, este valor es siempre 1. Para los objetivos obtenidos a través de QRhiSwapChain, el valor refleja la device pixel ratio del QWindow al que se dirige.

[pure virtual] QSize QRhiRenderTarget::pixelSize() const

Devuelve el tamaño en píxeles.

Solo es válido después de que se haya llamado correctamente a create(). Hasta entonces, el resultado es un objeto de tipo ` QSize` construido por defecto.

Con ` QRhiTextureRenderTarget `, el tamaño devuelto es el de los archivos adjuntos asociados en el momento de la llamada a `create()`; en la práctica, el tamaño del primer archivo adjunto de color o, si no hay archivos adjuntos de color, el del búfer de profundidad o de plantilla. Si las texturas o los búferes de renderizado asociados se redimensionan y se reconstruyen posteriormente, entonces `pixelSize()` realiza una llamada implícita a `create()` para reconstruir las estructuras de datos subyacentes. Esta comprobación implícita es similar a lo que hace ` QRhiCommandBuffer::beginPass()`, y garantiza que el tamaño devuelto esté siempre actualizado.

QRhiRenderPassDescriptor *QRhiRenderTarget::renderPassDescriptor() const

Devuelve el objeto ` QRhiRenderPassDescriptor` asociado.

Véase también setRenderPassDescriptor().

[pure virtual] int QRhiRenderTarget::sampleCount() const

Devuelve el número de muestras o 1 si el antialiasing multimuestra no es relevante para este destino de renderizado.

void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Establece el objeto de renderizado « QRhiRenderPassDescriptor » desc para su uso con este destino de renderizado.

Véase también renderPassDescriptor().

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