QRhiResourceUpdateBatch Class

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

void QRhiResourceUpdateBatch::copyTexture(QRhiTexture *dst, QRhiTexture *src, const QRhiTextureCopyDescription &desc = QRhiTextureCopyDescription())

desc で説明されているように、src からdst へのテクスチャ間コピー操作をエンキューします。

void QRhiResourceUpdateBatch::generateMips(QRhiTexture *tex)

指定されたテクスチャのミップマップ生成操作をエンキューするtex 。

2D テクスチャと立方体テクスチャの両方がサポートされています。

bool QRhiResourceUpdateBatch::hasOptimalCapacity() const

このバッチにエンキューされたバッファとテクスチャ操作の数が妥当な制限を下回るまでtrueを返します。

このバッチに追加されたバッファおよび/またはテクスチャ操作の数が、ある限界に達したか、または達しそうになると、戻り値はfalseになります。バッチはその後も完全に機能しますが、追加のメモリを割り当てる必要があるかもしれません。したがって、フレームを準備するときにバッファとテクスチャの更新を1つのバッチにたくさん集めるレンダラーは、この関数がfalseを返したときにsubmitting the batch 、starting a new one 。

void QRhiResourceUpdateBatch::merge(QRhiResourceUpdateBatch *other)

other バッチからこのバッチに、キューに入れられたすべての操作をコピーします。

これによって、初期化ステップで既知のリソース更新をバッチに集め、後で最初のレンダーパスを開始するときに別のバッチにマージするという便利なパターンが可能になる：

void init()
{
    initialUpdates = rhi->nextResourceUpdateBatch();
    initialUpdates->uploadStaticBuffer(vbuf, vertexData);
    initialUpdates->uploadStaticBuffer(ibuf, indexData);
    // ...
}

void render()
{
    QRhiResourceUpdateBatch *resUpdates = rhi->nextResourceUpdateBatch();
    if (initialUpdates) {
        resUpdates->merge(initialUpdates);
        initialUpdates->release();
        initialUpdates = nullptr;
    }
    // resUpdates->updateDynamicBuffer(...);
    cb->beginPass(rt, clearCol, clearDs, resUpdates);
}

void QRhiResourceUpdateBatch::readBackBuffer(QRhiBuffer *buf, quint32 offset, quint32 size, QRhiReadbackResult *result)

QRhiBuffer buf のリージョンの読み出しをエンキューする。領域のサイズはバイト単位でsize で指定され、offset は読み込みを開始するバイト単位のオフセットである。

リードバックは非同期である。result には、操作が完了したときに呼び出されるコールバックが含まれている。データはQRhiReadbackResult::data で提供される。成功すると、QByteArray のサイズはsize と等しくなる。失敗すると、QByteArray は空になる。

readBackTexture()、QRhi::isFeatureSupported()、QRhi::resourceLimit()も参照 。

void QRhiResourceUpdateBatch::readBackTexture(const QRhiReadbackDescription &rb, QRhiReadbackResult *result)

rb で説明されているように、テクスチャからホストへのコピー操作をエンキューします。

通常、rb はソースとしてQRhiTexture を指定します。しかし、現在のフレームのスワップチェーンがQRhiSwapChain::UsedAsTransferSource で作成された場合、それをリードバックのソースにすることもできます。この場合、rb でテクスチャをNULLに設定しておきます。

他の操作と異なり、ここでの結果はアプリケーションで処理する必要があります。したがって、result 、データだけでなくコールバックも提供します。バッチに対する操作はもともと非同期だからです：

rhi->beginFrame(swapchain);
cb->beginPass(swapchain->currentFrameRenderTarget(), colorClear, dsClear);
// ...
QRhiReadbackResult *rbResult = new QRhiReadbackResult;
rbResult->completed = [rbResult] {
    {
        const QImage::Format fmt = QImage::Format_RGBA8888_Premultiplied; // fits QRhiTexture::RGBA8
        const uchar *p = reinterpret_cast<const uchar *>(rbResult->data.constData());
        QImage image(p, rbResult->pixelSize.width(), rbResult->pixelSize.height(), fmt);
        image.save("result.png");
    }
    delete rbResult;
};
QRhiResourceUpdateBatch *u = nextResourceUpdateBatch();
QRhiReadbackDescription rb; // no texture -> uses the current backbuffer of sc
u->readBackTexture(rb, rbResult);
cb->endPass(u);
rhi->endFrame(swapchain);

1回のリードバック操作で、1つのレイヤー（キューブマップ面または3Dスライスまたはテクスチャ配列要素）の1つのmipレベルがコピーされます。レベルとレイヤはrb の各フィールドで指定します。

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

void QRhiResourceUpdateBatch::release()

バッチをプールに返します。これは、QRhiCommandBuffer::beginPass()、QRhiCommandBuffer::endPass()、QRhiCommandBuffer::resourceUpdate() のいずれかにバッチが渡されていない場合にのみ使用する必要があります。これらは暗黙的に destroy() を呼び出すからです。

void QRhiResourceUpdateBatch::updateDynamicBuffer(QRhiBuffer *buf, quint32 offset, quint32 size, const void *data)

QRhiBuffer::Dynamic 型で作成されたQRhiBuffer buf の領域を更新するエンキュー。

領域はoffset とsize で指定される。実際に書き込むバイトは、data で指定される。 は、少なくともsize バイトが利用可能でなければならない。data は、この関数が返ると、安全に破棄または変更できる。

void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, quint32 offset, quint32 size, const void *data)

QRhiBuffer::Immutable またはQRhiBuffer::Static タイプで作成されたQRhiBuffer buf の領域を更新するエンキュー。

領域はoffset とsize で指定される。実際に書き込むバイトは、data で指定される。 は、少なくともsize バイトが利用可能でなければならない。data は、この関数が返ると安全に破棄または変更できる。

void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, const void *data)

これはオーバーロードされた関数である。

QRhiBuffer::Immutable またはQRhiBuffer::Static の型で作成されたQRhiBuffer buf 全体の更新を待ち行列に入れます。

void QRhiResourceUpdateBatch::uploadTexture(QRhiTexture *tex, const QImage &image)

テクスチャのレイヤー0のミップレベル0のイメージデータをアップロードするためにエンキューtex 。

tex は非圧縮フォーマットでなければなりません。また、そのフォーマットは の () と互換性がなければなりません。ソースデータは で与えられます。image QImage::format image

void QRhiResourceUpdateBatch::uploadTexture(QRhiTexture *tex, const QRhiTextureUploadDescription &desc)

テクスチャの1つまたは複数のレイヤーの1つまたは複数のミップレベルのイメージデータをアップロードするエンキューtex 。

コピーの詳細（ソースQImage または圧縮テクスチャデータ、リージョン、ターゲットレイヤーとレベル）は、desc で説明されています。