QRhiShaderResourceBindings Class
バッファ、テクスチャ、サンプラーリソースをシェーダーから見えるようにするためのリソースをカプセル化します。詳細...
| Header: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Since: | Qt 6.6 |
| Inherits: | QRhiResource |
パブリックタイプ
| flags | UpdateFlags |
パブリック関数
| const QRhiShaderResourceBinding * | bindingAt(qsizetype index) const |
| qsizetype | bindingCount() const |
| const QRhiShaderResourceBinding * | cbeginBindings() const |
| const QRhiShaderResourceBinding * | cendBindings() const |
| bool | isLayoutCompatible(const QRhiShaderResourceBindings *other) const |
| QVector<quint32> | serializedLayoutDescription() const |
| void | setBindings(std::initializer_list<QRhiShaderResourceBinding> list) |
| void | setBindings(InputIterator first, InputIterator last) |
再実装されたパブリック関数
| virtual QRhiResource::Type | resourceType() const override |
詳細説明
QRhiShaderResourceBindings は、QRhiShaderResourceBinding オブジェクトのコレクションで、各オブジェクトは単一のバインディングを記述します。
次のインターフェイスを持つフラグメントシェーダを例にとります：
layout(std140, binding = 0) uniform buf {
mat4 mvp;
int flip;
} ubuf;
layout(binding = 1) uniform sampler2D tex;リソースをシェーダに見えるようにするには、次の QRhiShaderResourceBindings を作成し、QRhiGraphicsPipeline::setShaderResourceBindings() に渡します：
QRhiShaderResourceBindings *srb = rhi->newShaderResourceBindings(); srb->setBindings({ QRhiShaderResourceBinding::uniformBuffer(0, QRhiShaderResourceBinding::VertexStage | QRhiShaderResourceBinding::FragmentStage, ubuf), QRhiShaderResourceBinding::sampledTexture(1, QRhiShaderResourceBinding::FragmentStage, texture, sampler) }); srb->create(); // ... QRhiGraphicsPipeline *ps = rhi->newGraphicsPipeline(); // ... ps->setShaderResourceBindings(srb); ps->create(); // ... cb->setGraphicsPipeline(ps); cb->setShaderResources(); // binds srb
これは、ubuf がQRhiBuffer であり、texture がQRhiTexture であり、sampler がQRhiSampler であると仮定しています。また、この例では、頂点シェーダにもユニフォームブロックが存在すると仮定しているので、同じバッファが頂点ステージからも見えるようになります。
高度な使用法
上記の例をもとに、まったく同じパイプラインとシェーダを、異なるテクスチャで使 用するパスが必要だと仮定してみましょう。このためだけにまったく別のQRhiGraphicsPipeline を作成するのはやりすぎでしょう。このため、QRhiCommandBuffer::setShaderResources （）では、srb 引数を指定できます。2つのQRhiShaderResourceBindings間でレイアウト（バインディングの数とバインディングポイント）が一致する限り、パイプラインが最初にどちらかで作成されたと仮定して、どちらも同じパイプラインで使用できます。詳細はisLayoutCompatible() を参照してください。
QRhiShaderResourceBindings *srb2 = rhi->newShaderResourceBindings(); // ... cb->setGraphicsPipeline(ps); cb->setShaderResources(srb2); // binds srb2
注意: これは互換性が限定的に保証された RHI API です。詳細はQRhi を参照してください。
メンバー関数ドキュメント
const QRhiShaderResourceBinding *QRhiShaderResourceBindings::bindingAt(qsizetype index) const
指定されたindex でのバインディングを返す。
qsizetype QRhiShaderResourceBindings::bindingCount() const
バインディングの数を返します。
const QRhiShaderResourceBinding *QRhiShaderResourceBindings::cbeginBindings() const
バインディングリストの最初の項目を指す const イテレータを返します。
const QRhiShaderResourceBinding *QRhiShaderResourceBindings::cendBindings() const
バインディングリストの最後の項目の直後を指す const イテレータを返します。
bool QRhiShaderResourceBindings::isLayoutCompatible(const QRhiShaderResourceBindings *other) const
レイアウトがother と互換性がある場合はtrue を返します。レイアウトには、実際のリソース（バッファやテクスチャなど）や関連するパラメータ（オフセットやサイズなど）は含まれません。ただし、バインディングポイント、パイプラインステージ、リソースタイプは含まれます。互換性を保つためには、バインディングの数と順序も一致しなければなりません。
このQRhiShaderResourceBindings で作成されたQRhiGraphicsPipeline があり、この関数がtrue を返す場合、other はQRhiCommandBuffer::setShaderResources() に安全に渡すことができ、このQRhiShaderResourceBindings の代わりにパイプラインで使用することができます。
注： この関数は、create()が成功した後にのみ呼び出されなければならない。なぜなら、この関数は、基礎となるデータ構造の構築中に生成されたデータに依存しているからである。こうすることで、この関数は、2つのバインディング・リストを繰り返し処理し、各ペアでQRhiShaderResourceBinding::isLayoutCompatible() を呼び出すよりも効率的な比較アプローチを実装することができます。このことは、特にこの関数が高い頻度で呼び出される場合に重要になります。
serializedLayoutDescription()も参照してください 。
[override virtual] QRhiResource::Type QRhiShaderResourceBindings::resourceType() const
再インプリメント：QRhiResource::resourceType() const.
リソース型を返します。
QVector<quint32> QRhiShaderResourceBindings::serializedLayoutDescription() const
バインディングリストのレイアウトを記述する不透明なブロブ，つまりlayout compatibility tests に関連するデータを含む整数のベクトルを返します．
2つのオブジェクトsrb1 とsrb2 が与えられたとき、この関数から返されるデータが同じであれば、srb1->isLayoutCompatible(srb2) も、またその逆も同様です。
注： 返されたデータは、そのオブジェクトが属するQRhi の存続期間中、メモリへの保存と比較に使用されることを意図しています。ディスクに保存したり、プロセス間で再利用したり、異なるバックエンドを持つ可能性のある複数のQRhi インスタンスで使用したりするためのものではありません。
isLayoutCompatible()も参照してください 。
void QRhiShaderResourceBindings::setBindings(std::initializer_list<QRhiShaderResourceBinding> list)
バインディングのlist を設定します。
template <typename InputIterator> void QRhiShaderResourceBindings::setBindings(InputIterator first, InputIterator last)
イテレータfirst とlast からバインディングのリストを設定します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
