QRhiRenderTarget Class
Representa un objetivo de renderizado en pantalla (swapchain) o fuera de pantalla (textura). 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 |
| Hereda de: | QRhiResource |
| Heredado por: |
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. Es la subclase QRhiTextureRenderTarget la que pueden instanciar los clientes de la API a través de newTextureRenderTarget(). La otra subclase es QRhiSwapChainRenderTarget, que es el tipo que devuelve QRhiSwapChain cuando se llama a currentFrameRenderTarget().
Nota: Se trata de una API RHI con garantías de compatibilidad limitadas, véase QRhi para más detalles.
Véase también QRhiSwapChainRenderTarget y QRhiTextureRenderTarget.
Documentación de las funciones miembro
[pure virtual] float QRhiRenderTarget::devicePixelRatio() const
Devuelve la proporción de píxeles del dispositivo. Para QRhiTextureRenderTarget siempre es 1. Para los objetivos recuperados de un QRhiSwapChain, el valor refleja el device pixel ratio del QWindow objetivo.
[pure virtual] QSize QRhiRenderTarget::pixelSize() const
Devuelve el tamaño en píxeles.
Válido sólo después de que create() haya sido llamada con éxito. Hasta entonces el resultado es un QSize construido por defecto.
Con QRhiTextureRenderTarget el tamaño devuelto es el tamaño de los anexos asociados en el momento de create(), en la práctica el tamaño del primer anexo de color, o el búfer de profundidad/esténcil si no hay anexos de color. Si las texturas asociadas o los renderbuffers son redimensionados y reconstruidos 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 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 objetivo de renderizado.
void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)
Establece el QRhiRenderPassDescriptor desc para su uso con este objetivo 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.
