QRhiRenderPassDescriptor Class

メンバ関数ドキュメント

[pure virtual] bool QRhiRenderPassDescriptor::isCompatible(const QRhiRenderPassDescriptor *other) const

other QRhiRenderPassDescriptor がこれと互換性がある場合、true を返す。つまり、this とother は、QRhiGraphicsPipeline::setRenderPassDescriptor() で互換的に使用できる。

レンダーパス記述子の互換性の概念は、QRhiShaderResourceBindings インスタンスのlayout compatibility と似ています。QRhiGraphicsPipeline 例えば、QRhiGraphicsPipeline インスタンスキャッシュは、単にポインタを比較するのではなく、一致するパイプラインを探すためにこれらの関数を使用することが期待されます。したがって、互換性がある限り、異なるQRhiRenderPassDescriptor とQRhiShaderResourceBindings をパイプラインと組み合わせて使用することができます。

互換性の正確な詳細は、基盤となるグラフィックスAPIに依存する。同じQRhiTextureRenderTarget からの2つのレンダーパス記述子created は、常に互換性がある。

QRhiShaderResourceBindings と同様に、2つの既存のオブジェクトが利用可能でなくても、互換性をテストすることができます。serializedFormat （）を呼び出して不透明ブロブを抽出すると、返されたベクトルを別のQRhiRenderPassDescriptor のserializedFormat （）と比較して互換性をテストできます。これは、パイプラインが元々構築されていたQRhiRenderPassDescriptor が使用できなくなった場合でも、QRhiRenderPassDescriptor とQRhiGraphicsPipeline の互換性をテストできる（ただし、serializedFormat() から返されるデータは使用可能）ため、特定の状況でメリットがあります。

newCompatibleRenderPassDescriptor() およびserializedFormat()も参照のこと 。

[virtual] const QRhiNativeHandles *QRhiRenderPassDescriptor::nativeHandles()

QRhiVulkanRenderPassNativeHandles のような、バックエンド固有のQRhiNativeHandles サブクラスへのポインタを返します。基盤となるネイティブリソースの公開がバックエンドでサポートされていない場合、返される値はnullptr となります。

QRhiVulkanRenderPassNativeHandlesも参照ください 。

[pure virtual] QRhiRenderPassDescriptor *QRhiRenderPassDescriptor::newCompatibleRenderPassDescriptor() const

このオブジェクトとcompatible である新しいQRhiRenderPassDescriptor を返す。

この関数を使用すると、QRhiRenderPassDescriptor のクローンを作成することができます。返されたオブジェクトはすぐに使用でき、所有権は呼び出し元に移ります。QRhiRenderPassDescriptor オブジェクトのクローンは、オブジェクトがグラフィックス パイプラインに関連するデータ構造に格納されており（レンダーパス記述子オブジェクトを必要とする新しいパイプラインを作成できるようにするため）、レンダー ターゲットから作成されるレンダーパス記述子の寿命がパイプラインよりも短い可能性がある状況で役立ちます。(たとえば、エンジンはレンダーパスをテクスチャやレンダーターゲットから作成されたものと一緒に管理し、破棄するため) このような状況では、データ構造にクローンされたバージョンを保存し、所有権も転送することが有益な場合があります。

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

[override virtual] QRhiResource::Type QRhiRenderPassDescriptor::resourceType() const

再実装：QRhiResource::resourceType() const.

リソース型を返します。

[pure virtual] QVector<quint32> QRhiRenderPassDescriptor::serializedFormat() const

compatibility に関連するデータを記述する不透明なブロブを含む整数のベクトルを返す。

2つのQRhiRenderPassDescriptor オブジェクトrp1 とrp2 が与えられたとき、この関数から返されるデータが同一であれば、rp1->isCompatible(rp2) も、またその逆も同様である。

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