QRhiResource Class

成员函数文档

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

复制并构造一个QRhiResource 实例。该函数已被删除。

[virtual noexcept] QRhiResource::~QRhiResource()

析构函数。

释放（或请求延迟释放）底层本机图形资源（如有）。

另请参阅 destroy()。

void QRhiResource::deleteLater()

如果在未录制帧的情况下调用此函数，其效果等同于删除该对象。但在QRhi::beginFrame()和QRhi::endFrame()之间，其行为有所不同：QRhiResource 不会被销毁，直到该帧通过QRhi::endFrame()提交为止，从而满足QRhi 的要求，即不得更改被录制帧引用的QRhiResource 对象。

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

在许多情况下，使用 deleteLater() 非常方便， 它通过提供一种方法来确保 C++ 对象实例（如QRhiBuffer 、QRhiTexture 、 等）本身也能一直保持有效，直至当前帧结束。

以下示例展示了一种便捷的方法，用于创建仅在一个帧中使用并在 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()。

[pure virtual] void QRhiResource::destroy()

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

一旦调用 destroy()，可以通过再次调用create() 来重用该QRhiResource 实例。这将导致在底层创建新的本机图形资源。

QRhiResource 的析构函数也会执行相同的操作，因此在删除QRhiResource 之前无需调用此函数。

另请参阅 deleteLater()。

quint64 QRhiResource::globalResourceId() const

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

用户代码很少需要直接处理该值。该标识符仅用于内部跟踪和账务管理。

QByteArray QRhiResource::name() const

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

另请参阅 setName()。

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

返回资源的类型。

QRhi *QRhiResource::rhi() const

返回创建该资源的QRhi 。

如果创建此对象的QRhi 已被销毁，则返回nullptr 。

void QRhiResource::setName(const QByteArray &name)

为对象设置name 。

这使得可以在图形调试工具（如RenderDoc和XCode）中为原生图形资源获取描述性名称。

在通过相应的图形 API 传递名称来命名本机对象时，请注意：如果不支持QRhi::DebugMarkers ，该名称将被忽略；此外，根据后端的不同，如果未设置QRhi::EnableDebugMarkers ，该名称也可能被忽略。

另请参阅 name()。

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

将other 复制赋值给此QRhiResource 实例。该函数已被删除。