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() のいずれにも渡されない場合にのみ使用する。

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 に記載されています。