QRhiResource Class

メンバ関数ドキュメント

[virtual noexcept] QRhiResource::~QRhiResource()

デストラクタ。

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

destroy()も参照 。

void QRhiResource::deleteLater()

フレームが記録されていない状態でこの関数を呼び出すと、オブジェクトを削除するのと同じことになります。しかし、QRhi::beginFrame() とQRhi::endFrame() の間では、動作が異なります。QRhiResource は、QRhi::endFrame() によってフレームが送信されるまで破棄されないため、記録中のフレームによって参照される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()も参照してください 。