QRhiBuffer Class

QRhiBuffer *ubuf = rhi->newBuffer(QRhiBuffer::Dynamic, QRhiBuffer::UniformBuffer, 64);
if (!ubuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
QMatrix4x4 mvp;
// ... set up the modelview-projection matrix
batch->updateDynamicBuffer(ubuf, 0, 64, mvp.constData());
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

const float vertices[] = { -1.0f, -1.0f, 1.0f, -1.0f, 0.0f, 1.0f };
QRhiBuffer *vbuf = rhi->newBuffer(QRhiBuffer::Immutable, QRhiBuffer::VertexBuffer, sizeof(vertices));
if (!vbuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
batch->uploadStaticBuffer(vbuf, vertices);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

static const quint16 indices[] = { 0, 1, 2 };
QRhiBuffer *ibuf = rhi->newBuffer(QRhiBuffer::Immutable, QRhiBuffer::IndexBuffer, sizeof(indices));
if (!ibuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
batch->uploadStaticBuffer(ibuf, indices);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

if (buf->size() < newSize) {
    buf->setSize(newSize);
    if (!buf->create()) { error(); }
}
// continue using buf, fill it with new data

const int N = 2;
const int UB_SIZE = 64 + 4; // assuming a uniform block with { mat4 matrix; float opacity; }
const int ONE_UBUF_SIZE = rhi->ubufAligned(UB_SIZE);
const int TOTAL_UBUF_SIZE = N * ONE_UBUF_SIZE;
QRhiBuffer *ubuf = rhi->newBuffer(QRhiBuffer::Dynamic, QRhiBuffer::UniformBuffer, TOTAL_UBUF_SIZE);
if (!ubuf->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
for (int i = 0; i < N; ++i) {
    batch->updateDynamicBuffer(ubuf, i * ONE_UBUF_SIZE, 64, matrix.constData());
    batch->updateDynamicBuffer(ubuf, i * ONE_UBUF_SIZE + 64, 4, &opacity);
}
// ...
// beginPass(), set pipeline, etc., and then:
for (int i = 0; i < N; ++i) {
    QRhiCommandBuffer::DynamicOffset dynOfs[] = { { 0, i * ONE_UBUF_SIZE } };
    cb->setShaderResources(srb, 1, dynOfs);
    cb->draw(36);
}

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

[virtual] char *QRhiBuffer::beginFullDynamicBufferUpdateForCurrentFrame()

ホストから可視なバッファデータが格納されたメモリブロックへのポインタを返します。

これは、フレームごとに内容全体（あるいは少なくとも現在のフレームでシェーダーによって読み込まれるすべての領域）が変更され、QRhiResourceUpdateBatch に基づく更新メカニズムではデータコピーの量が多すぎて負荷が高すぎると判断される、中規模から大規模の動的ユニフォームバッファに対するショートカットです。

この関数を呼び出した後は、このバッファに依存するレンダリングパスやコンピュートパスを記録する前に、必ず endFullDynamicUniformBufferUpdateForCurrentFrame() を呼び出す必要があります。

[pure virtual] bool QRhiBuffer::create()

対応するネイティブグラフィックスリソースを作成します。以前にdestroy() を伴わない create() が実行された結果、すでにリソースが存在する場合、まず暗黙的にdestroy() が呼び出されます。

成功した場合はtrue を返し、グラフィックス操作が失敗した場合はfalse を返します。戻り値にかかわらず、destroy()を呼び出すことは常に安全です。

[virtual] void QRhiBuffer::endFullDynamicBufferUpdateForCurrentFrame()

beginFullDynamicBufferUpdateForCurrentFrame() から返されたメモリブロック内のバッファデータの全内容が更新されたときに呼び出されます。

[virtual] QRhiBuffer::NativeBuffer QRhiBuffer::nativeBuffer()

このバッファの基盤となるネイティブリソースを返します。バックエンドが基盤となるネイティブリソースの公開をサポートしていない場合、返される値は空になります。

QRhiBuffer は、使用されているtype()およびQRhi バックエンドによっては、複数のネイティブバッファオブジェクトによって裏付けられている場合があります。 その場合は、それらがすべて、返される構造体の objects 配列に返され、slotCount にはネイティブバッファオブジェクトの数が指定されます。recording a frame である間、QRhi::currentFrameSlot() を使用すると、記録中のフレーム内で、このQRhiBuffer からの読み取りまたは書き込み操作に対して、QRhi がどのネイティブバッファを使用しているかを確認できます。

場合によっては、QRhiBuffer がネイティブバッファオブジェクトによってまったく裏付けられていないこともあります。この場合、slotCountは0に設定され、有効なネイティブオブジェクトは返されません。これはエラーではなく、特定のタイプや使用方法のQRhiBufferに対して、そのバックエンドがネイティブバッファを使用しない場合には、完全に有効な動作です。

QRhi::currentFrameSlot() およびQRhi::FramesInFlightも参照してください 。

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

QRhiResource::resourceType() const を再実装します。

リソースの型を返します。

void QRhiBuffer::setSize(quint32 sz)

バッファのサイズをバイト単位で設定します。通常、サイズは `QRhi::newBuffer()` で指定されるため、この関数はサイズを変更する必要がある場合にのみ使用されます。他のセッターと同様、このサイズ設定は `create()` を呼び出したときにのみ有効になります。また、すでに作成済みのバッファの場合、内部的には以前のネイティブリソースを解放し、新しいリソースを作成する処理が行われます。

バックエンドは、アライメント要件を満たすために、sz で指定されたサイズよりも大きなバッファを割り当てる場合があります。これはアプリケーションからは隠蔽されており、size() は常にsz で要求されたサイズを報告します。

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

void QRhiBuffer::setType(QRhiBuffer::Type t)

バッファのタイプを「t 」に設定します。

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

void QRhiBuffer::setUsage(QRhiBuffer::UsageFlags u)

バッファの使用フラグを `u` に設定します。

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

quint32 QRhiBuffer::size() const

バッファのサイズをバイト単位で返します。

これは常に、setSize() またはQRhi::newBuffer() に渡された値となります。内部的には、基盤となるグラフィックス API によって必要とされる場合、ネイティブバッファのサイズがこれより大きくなる可能性があります。

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

QRhiBuffer::Type QRhiBuffer::type() const

バッファの型を返します。

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

QRhiBuffer::UsageFlags QRhiBuffer::usage() const

バッファの使用フラグを返します。

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