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