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 QRhiShaderResourceBinding *QRhiShaderResourceBindings::cendBindings() 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` 相关的数据。

给定两个对象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 的绑定列表。