QRhiResource 类

成员函数文档

[虚拟 noexcept] QRhiResource::~QRhiResource()

析构函数。

释放（或请求延迟释放）底层原生图形资源，如果有的话。

另请参阅 destroy（）。

void QRhiResource::deleteLater()

当没有记录帧时调用此函数相当于删除对象。然而在QRhi::beginFrame()和QRhi::endFrame()之间，其行为不同：QRhiResource将在通过QRhi::endFrame()提交帧之前不会被销毁，从而满足QRhi不改变正在记录的帧所引用的QRhiResource对象的规范。

如果创建此对象的QRhi已经被销毁，对象将被立即删除。

在许多情况下，使用deleteLater()可以是一个有用的便利，它通过提供一种确保C++对象实例（如QRhiBuffer、QRhiTexture等）本身直到当前帧结束也保持有效的方式，来补充低级保证（在底层原生图形对象安全且不再被GPU用于仍在执行的帧中时才销毁）。

以下示例展示了创建一次使用的缓冲区，它只在一帧中使用，并在endFrame()中自动释放的便捷方式。（至于底层的原生缓冲区，通常的保证适用：QRhi后端将延迟释放这些，直到能够保证缓冲区被GPU访问的帧已经完成）

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();

另请参阅 destroy（）。

[纯虚函数] void QRhiResource::destroy()

释放（或请求延迟释放）底层原生图形资源。可以多次安全调用，后续调用将不执行任何操作。

一旦调用了destroy()，可以通过再次调用create()来重复使用QRhiResource实例。这将在其下方创建新的原生图形资源。

QRhiResource析构函数也执行相同的任务，因此删除QRhiResource之前无需调用此函数。

另请参阅deleteLater().

quint64 QRhiResource::globalResourceId() const

返回此QRhiResource的全局唯一标识符。

用户很少需要直接处理此值。它用于内部的跟踪和记录目的。

QByteArray QRhiResource::name() const

返回目前设置的对象名称。默认情况下名称为空。

另请参阅setName().

[纯虚函数] QRhiResource::Type QRhiResource::resourceType() const

返回资源类型。

QRhi *QRhiResource::rhi() const

返回创建此资源的QRhi。

如果创建此对象的QRhi已经被销毁，结果将是null指针。

void QRhiResource::setName(const QByteArray &name)

为对象设置一个名称。

这允许在如RenderDoc和XCode等图形调试工具中查看的本地图形资源上获取描述性名称。

使用适当的图形API传递名称来命名本地对象时，请注意，当不支持QRhi::DebugMarkers 时，名称会被忽略，并且根据后端，当QRhi::EnableDebugMarkers 未设置时，名称也可能被忽略。

另请参阅 name()。