QRhiResource Class

メンバ関数ドキュメント

[virtual noexcept] QRhiResource::~QRhiResource()

デストラクタ。

基礎となるネイティブ・グラフィックス・リソースがある場合は、それを解放します（または解放の延期を要求します）。

destroy()も参照してください 。

void QRhiResource::deleteLater()

フレームが記録されていない状態で呼び出された場合、この関数はオブジェクトを削除するのと同じことになります。しかし、QRhi::beginFrame （）とQRhi::endFrame （）の間では動作が異なります。QRhi::endFrame （）を介してフレームが送信されるまで、QRhiResource は破棄されないため、記録中のフレームによって参照されるQRhiResource オブジェクトを変更しないというQRhi の要件を満たします。

このオブジェクトを生成したQRhi がすでに破棄されている場合、オブジェクトは即座に削除されます。

deleteLater()を使用することは、多くの場合に便利であり、C++ オブジェクトのインスタンス（QRhiBuffer 、QRhiTexture など）自体も現在のフレームが終了するまで有効であることを確認する方法を提供することによって、低レベルの保証（そうすることが安全であり、それらがまだ飛行中のフレームで GPU によって使用されていないことが確実にわかるまで、基礎となるネイティブ・グラフィックス・オブジェクトが決して破棄されないこと）を補完します。

次の例は、1 つのフレームでのみ使用され、endFrame() で自動的に解放されるスローアウェイ・バッファを作成する便利な方法を示しています。(バッファが GPU によってアクセスされるフレームが完了することが保証されるまで、QRhi バックエンドはバッファの解放を延期します）。

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()も参照のこと 。