En esta página

QRhiResource Class

Clase base para clases que encapsulan objetos de recursos nativos. 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 por:
12 tipos

QRhiBuffer, QRhiCommandBuffer, QRhiComputePipeline, QRhiGraphicsPipeline, QRhiRenderBuffer, QRhiRenderPassDescriptor, QRhiRenderTarget, QRhiSampler, QRhiShaderResourceBindings, QRhiShadingRateMap, QRhiSwapChain, y QRhiTexture

Tipos públicos

enum Type { Buffer, Texture, Sampler, RenderBuffer, RenderPassDescriptor, …, ShadingRateMap }

Funciones públicas

virtual ~QRhiResource()
void deleteLater()
virtual void destroy() = 0
quint64 globalResourceId() const
QByteArray name() const
virtual QRhiResource::Type resourceType() const = 0
QRhi *rhi() const
void setName(const QByteArray &name)

Funciones protegidas

QRhiResource(const QRhiResource &)
QRhiResource &operator=(const QRhiResource &)

Descripción detallada

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 QRhiResource::Type

Especifica el tipo de recurso.

ConstanteValor
QRhiResource::Buffer0
QRhiResource::Texture1
QRhiResource::Sampler2
QRhiResource::RenderBuffer3
QRhiResource::RenderPassDescriptor4
QRhiResource::SwapChainRenderTarget5
QRhiResource::TextureRenderTarget6
QRhiResource::ShaderResourceBindings7
QRhiResource::GraphicsPipeline8
QRhiResource::SwapChain9
QRhiResource::ComputePipeline10
QRhiResource::CommandBuffer11
QRhiResource::ShadingRateMap12

Documentación de la función miembro

[protected delete] QRhiResource::QRhiResource(const QRhiResource &)

Crea una instancia de ` QRhiResource` mediante copia. Esta función se ha eliminado.

[virtual noexcept] QRhiResource::~QRhiResource()

Destructor.

Libera (o solicita la liberación diferida de) los recursos gráficos nativos subyacentes, si los hay.

Nota: Los recursos a los que hacen referencia los comandos del fotograma actual no deben liberarse hasta que el fotograma se envíe mediante QRhi::endFrame().

Véase también destroy().

void QRhiResource::deleteLater()

Cuando se invoca sin que se esté grabando ningún fotograma, esta función equivale a eliminar el objeto. Sin embargo, entre una llamada a ` QRhi::beginFrame()` y a ` QRhi::endFrame()`, el comportamiento es diferente: el objeto ` QRhiResource ` no se destruirá hasta que el fotograma se envíe mediante ` QRhi::endFrame()`, cumpliendo así el requisito de ` QRhi ` de no alterar los objetos ` QRhiResource ` a los que hace referencia el fotograma que se está grabando.

Si el QRhi que creó este objeto ya ha sido destruido, el objeto se elimina inmediatamente.

El uso de `deleteLater()` puede resultar muy práctico en muchos casos, y complementa la garantía de bajo nivel (de que los objetos gráficos nativos subyacentes nunca se destruyen hasta que sea seguro hacerlo y se sepa con certeza que la GPU no los está utilizando en un fotograma aún en proceso), al ofrecer una forma de garantizar que las instancias de los objetos C++ (de QRhiBuffer, QRhiTexture, etc.) también permanezcan válidas hasta el final del fotograma actual.

El siguiente ejemplo muestra una forma práctica de crear un búfer desechable que solo se utiliza en un fotograma y se libera automáticamente en endFrame(). (En lo que respecta a los búferes nativos subyacentes, se aplica la garantía habitual: el backend QRhi aplaza la liberación de estos hasta que se garantice que el fotograma en el que la GPU accede al búfer se ha completado)

rhi->beginFrame(swapchain);
QRhiBuffer *buf = rhi->newBuffer(QRhiBuffer::Immutable, QRhiBuffer::VertexBuffer, 256);
buf->deleteLater(); // !
u = rhi->nextResourceUpdateBatch();
u->uploadStaticBuffer(buf, data);
// ... draw with buf
rhi->endFrame();

Véase también destroy().

[pure virtual] void QRhiResource::destroy()

Libera (o solicita la liberación diferida de) los recursos gráficos nativos subyacentes. Se puede llamar varias veces sin problema; las invocaciones posteriores no tendrán ningún efecto.

Una vez llamada la función `destroy()`, la instancia de ` QRhiResource ` puede reutilizarse llamando de nuevo a ` create() `. Esto dará lugar a la creación de nuevos recursos gráficos nativos subyacentes.

Nota: Los recursos a los que hacen referencia los comandos del fotograma actual no deben liberarse hasta que QRhi::endFrame() envíe el fotograma.

El destructor de ` QRhiResource ` también realiza la misma tarea, por lo que no es necesario llamar a esta función antes de eliminar un ` QRhiResource`.

Véase también deleteLater().

quint64 QRhiResource::globalResourceId() const

Devuelve el identificador global y único de este QRhiResource.

El código de usuario rara vez necesita manejar este valor directamente. Se utiliza internamente con fines de seguimiento y contabilidad.

QByteArray QRhiResource::name() const

Devuelve el nombre del objeto establecido actualmente. Por defecto, el nombre está vacío.

Véase también setName().

[pure virtual] QRhiResource::Type QRhiResource::resourceType() const

Devuelve el tipo del recurso.

QRhi *QRhiResource::rhi() const

Devuelve el objeto ` QRhi ` que creó este recurso.

Si el objeto « QRhi » que creó este objeto ya se ha destruido, el resultado es « nullptr ».

void QRhiResource::setName(const QByteArray &name)

Establece un « name » para el objeto.

Esto permite obtener nombres descriptivos para los recursos gráficos nativos visibles en herramientas de depuración gráfica, como RenderDoc y XCode.

A la hora de nombrar objetos nativos transmitiendo el nombre a través de la API gráfica adecuada, ten en cuenta que el nombre se ignora cuando no se admiten los « QRhi::DebugMarkers » y que, dependiendo del backend, también puede ignorarse cuando no se ha establecido « QRhi::EnableDebugMarkers ».

Nota: El nombre puede ignorarse para objetos distintos de los búferes, los búferes de renderizado y las texturas, dependiendo del backend.

Nota: El nombre puede modificarse. En el caso de los recursos con ranuras, como un ` QRhiBuffer ` respaldado por varios búferes nativos, ` QRhi ` añadirá un sufijo para que los búferes nativos subyacentes se puedan distinguir fácilmente entre sí.

Véase también name().

[protected delete] QRhiResource &QRhiResource::operator=(const QRhiResource &)

Asigna por copia other a esta instancia de QRhiResource. Esta función se ha eliminado.

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