QRhiTextureRenderTarget Class
Recurso de destino de renderizado de texturas. Más...
| 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: | QRhiRenderTarget |
Tipos públicos
| enum | Flag { PreserveColorContents, PreserveDepthStencilContents, DoNotStoreDepthStencilContents } |
| flags | Flags |
Funciones públicas
| virtual bool | create() = 0 |
| QRhiTextureRenderTargetDescription | description() const |
| QRhiTextureRenderTarget::Flags | flags() const |
| virtual QRhiRenderPassDescriptor * | newCompatibleRenderPassDescriptor() = 0 |
| void | setDescription(const QRhiTextureRenderTargetDescription &desc) |
| void | setFlags(QRhiTextureRenderTarget::Flags f) |
Funciones públicas reimplementadas
| virtual QRhiResource::Type | resourceType() const override |
Descripción detallada
Un destino de renderizado de texturas permite renderizar en una o más texturas, opcionalmente con una textura de profundidad o un búfer de renderizado de profundidad/plantilla.
Para el renderizado multimuestra, el enfoque habitual consiste en utilizar un búfer de renderizado como «color attachment» y establecer la textura de destino no multimuestra como « resolve texture ». Para obtener más información, consulta la descripción detallada de la clase « QRhiColorAttachment ».
Nota: Las texturas utilizadas en combinación con QRhiTextureRenderTarget deben crearse con el indicador « QRhiTexture::RenderTarget ».
El ejemplo más sencillo de creación de un destino de renderizado con una textura como único anexo de color:
QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, size, 1, QRhiTexture::RenderTarget);
texture->create();
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget({ texture });
rp = rt->newCompatibleRenderPassDescriptor();
rt->setRenderPassDescriptor(rp);
rt->create();
// rt can now be used with beginPass()Nota: Se trata de una API de RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.
Documentación sobre los tipos de miembros
enum QRhiTextureRenderTarget::Flag
flags QRhiTextureRenderTarget::Flags
Valores de indicador que describen el comportamiento de carga/almacenamiento del destino de renderizado. El comportamiento de carga/almacenamiento puede integrarse en los recursos nativos de forma interna, dependiendo del backend, por lo que debe conocerse de antemano y no puede modificarse sin volver a compilar (y, por lo tanto, sin publicar y crear nuevos recursos nativos).
| Constante | Valor | Descripción |
|---|---|---|
QRhiTextureRenderTarget::PreserveColorContents | 1 << 0 | Indica que el contenido de los archivos adjuntos de color debe cargarse al iniciar una pasada de renderizado, en lugar de borrarse. Esto puede resultar más costoso, especialmente en GPU móviles (en mosaico), pero permite conservar el contenido existente entre pasadas. Al realizar un renderizado multimuestra con un conjunto de texturas de resolución, al activar este indicador también se solicita que los datos de color multimuestra se almacenen (se escriban) en la textura multimuestra o en el búfer de renderizado. (En el renderizado no multimuestra, los datos de color siempre se almacenan; sin embargo, en el caso del MSAA, el almacenamiento de los datos multimuestra reduce la eficiencia en determinadas arquitecturas de GPU, por lo que, por defecto, no se escriben). Sin embargo, ten en cuenta que esto no es portable: en algunos casos no existe una textura multimuestra intermedia a nivel de la API gráfica, por ejemplo, al utilizar la función « GL_EXT_multisampled_render_to_texture » de OpenGL ES, ya que todo es implícito y lo gestiona la implementación de OpenGL ES. En ese caso, es probable que «PreserveColorContents» no tenga ningún efecto. Por lo tanto, evite confiar en este indicador cuando utilice el renderizado multimuestra y el adjunto de color utilice un QRhiTexture multimuestra (no QRhiRenderBuffer). |
QRhiTextureRenderTarget::PreserveDepthStencilContents | 1 << 1 | Indica que el contenido de la textura de profundidad debe cargarse al iniciar una pasada de renderizado, en lugar de borrarse. Solo es aplicable cuando se utiliza una textura como búfer de profundidad (se ha establecido `QRhiTextureRenderTargetDescription::depthTexture()`), ya que los búferes de renderizado de profundidad/estarcido pueden no tener ningún soporte físico y es posible que los datos ni siquiera se escriban. |
QRhiTextureRenderTarget::DoNotStoreDepthStencilContents | 1 << 2 | Indica que no es necesario escribir el contenido de la textura de profundidad. Solo es relevante cuando se utiliza un ` QRhiTexture`, y no un ` QRhiRenderBuffer`, como búfer de profundidad-estencil, ya que para ` QRhiRenderBuffer ` esto es implícito. Cuando se establece `depthResolveTexture`, el indicador no es relevante, ya que el comportamiento es entonces como si el indicador estuviera establecido. Este valor de enumeración se introduce en Qt 6.8. |
El tipo Flags es un typedef para QFlags<Flag>. Almacena una combinación OR de valores de Flag.
Documentación de las funciones miembro
[pure virtual] bool QRhiTextureRenderTarget::create()
Crea los recursos gráficos nativos correspondientes. Si ya existen recursos debido a una llamada anterior a `create()` sin el ` destroy()` correspondiente, primero se invoca implícitamente ` destroy()`.
Nota: Se debe establecerrenderPassDescriptor() antes de llamar a create(). Para obtener un QRhiRenderPassDescriptor compatible con el destino de renderizado, llama a newCompatibleRenderPassDescriptor() antes de create(), pero después de establecer todos los demás parámetros, como description() y flags(). Para ahorrar recursos, reutiliza el mismo QRhiRenderPassDescriptor con varias instancias de QRhiTextureRenderTarget, siempre que sea posible. Compartir el mismo descriptor de pasada de renderizado solo es posible cuando los objetivos de renderizado tienen el mismo número y tipo de archivos adjuntos (las texturas reales pueden diferir) y los mismos indicadores.
Nota: los recursos , como las instancias de QRhiTexture, a los que se hace referencia en description() deben haber sido previamente creados mediante la función create().
Devuelve true si se realiza correctamente, y false si falla una operación gráfica. Independientemente del valor devuelto, llamar a destroy() siempre es seguro.
QRhiTextureRenderTargetDescription QRhiTextureRenderTarget::description() const
Devuelve la descripción del destino de renderizado.
Véase también setDescription().
QRhiTextureRenderTarget::Flags QRhiTextureRenderTarget::flags() const
Devuelve los indicadores establecidos actualmente.
Véase también setFlags().
[pure virtual] QRhiRenderPassDescriptor *QRhiTextureRenderTarget::newCompatibleRenderPassDescriptor()
Devuelve un nuevo objeto ` QRhiRenderPassDescriptor ` compatible con este destino de renderizado.
El valor devuelto se utiliza de dos maneras: puede pasarse a ` setRenderPassDescriptor()` y a ` QRhiGraphicsPipeline::setRenderPassDescriptor()`. Un descriptor de pasada de renderizado describe los anexos (color, profundidad/plantilla) y el comportamiento de carga/almacenamiento que puede verse afectado por ` flags()`. Un ` QRhiGraphicsPipeline ` solo puede utilizarse en combinación con un destino de renderizado que tenga un ` compatible ` ` QRhiRenderPassDescriptor ` establecido.
Dos instancias de « QRhiTextureRenderTarget » pueden compartir el mismo descriptor de pasada de renderizado siempre que tengan el mismo número y tipo de anexos. Las instancias asociadas de « QRhiTexture » o « QRhiRenderBuffer » no forman parte del descriptor de pasada de renderizado, por lo que pueden diferir entre las dos instancias de « QRhiTextureRenderTarget ».
Nota: los recursos , como las instancias de ` QRhiTexture `, a los que se hace referencia en ` description()` deben tener ya llamada la función ` create()`.
Véase también create().
[override virtual] QRhiResource::Type QRhiTextureRenderTarget::resourceType() const
Reimplementa: ` QRhiResource::resourceType()` const.
Devuelve el tipo de recurso.
void QRhiTextureRenderTarget::setDescription(const QRhiTextureRenderTargetDescription &desc)
Establece la descripción del destino de renderizado desc.
Véase también description().
void QRhiTextureRenderTarget::setFlags(QRhiTextureRenderTarget::Flags f)
Establece los indicadores en « f ».
Véase también flags().
© 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.