QRhiShaderResourceBindings Class

layout(std140, binding = 0) uniform buf {
    mat4 mvp;
    int flip;
} ubuf;

layout(binding = 1) uniform sampler2D tex;

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

QRhiShaderResourceBindings *srb2 = rhi->newShaderResourceBindings();
// ...
cb->setGraphicsPipeline(ps);
cb->setShaderResources(srb2); // binds srb2

メンバ関数のドキュメント

const QRhiShaderResourceBinding *QRhiShaderResourceBindings::bindingAt(qsizetype index) const

指定されたindex にあるバインディングを返します。

qsizetype QRhiShaderResourceBindings::bindingCount() const

バインディングの数を返します。

const QRhiShaderResourceBinding *QRhiShaderResourceBindings::cbeginBindings() const

バインディングリストの最初の項目を指す const イテレータを返します。

const QRhiShaderResourceBinding *QRhiShaderResourceBindings::cendBindings() const

バインディングリストの最後の要素の直後を指す const イテレータを返します。

[pure virtual] bool QRhiShaderResourceBindings::create()

対応するリソースバインディングセットを作成します。基盤となるグラフィックスAPIによっては、ネイティブのグラフィックスリソースの作成を伴う場合があるため、この操作が低コストであると想定すべきではありません。

以前に create() が呼び出されており、対応する `destroy()` が実行されていない場合、まず暗黙的に `destroy()` が呼び出されます。

成功した場合はtrue を、失敗した場合はfalse を返します。戻り値にかかわらず、destroy()の呼び出しは常に安全です。

bool QRhiShaderResourceBindings::isLayoutCompatible(const QRhiShaderResourceBindings *other) const

レイアウトがother と互換性がある場合、true を返します。レイアウトには、実際のリソース（バッファやテクスチャなど）や関連するパラメータ（オフセットやサイズなど）は含まれません。ただし、バインディングポイント、パイプラインステージ、およびリソースタイプは含まれます。互換性があるためには、バインディングの数と順序も一致している必要があります。

このQRhiShaderResourceBindings を使用してQRhiGraphicsPipeline が作成され、関数がtrue を返した場合、other をQRhiCommandBuffer::setShaderResources()に安全に渡すことができ、このQRhiShaderResourceBindings の代わりにパイプラインで使用できます。

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) が成り立ち、その逆も同様に成り立ちます。

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

void QRhiShaderResourceBindings::setBindings(std::initializer_list<QRhiShaderResourceBinding> list)

バインディングのlist を設定します。

template <typename InputIterator> void QRhiShaderResourceBindings::setBindings(InputIterator first, InputIterator last)

イテレータ `first ` および `last` からのバインディングのリストを設定します。