QRhiResourceUpdateBatch 类

成员函数文档

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

将 src 中的纹理复制到 dst，具体操作由 desc 描述。

void QRhiResourceUpdateBatch::generateMips(QRhiTexture *tex)

为指定的纹理 tex 队列一个生成MIP贴图的操作。

支持2D和立方体贴图。

bool QRhiResourceUpdateBatch::hasOptimalCapacity() const

当在当前批次中排队等候的缓冲区和纹理操作的数量低于合理限制时，返回true。

当添加到当前批次的缓冲区和/或纹理操作的数量达到或即将达到某一限制时，将返回false。此后，批次仍然完全功能正常，但可能需要分配额外的内存。因此，当准备帧时在一个批次中收集大量缓冲区和纹理更新的渲染器可能想要在函数返回false时考虑 提交批次 并 启动一个新的批次。

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作为源。但是，当当前帧的swapchain使用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);

单个读取操作一次复制一个层的单个MIP级别（立方体贴面或3D切片或纹理数组元素）。级别和层分别由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 QRhiTextureUploadDescription &desc)

将上传一个或多个纹理的一级或多层图像数据的更新任务加入队列。

复制的详细信息（源 QImage 或压缩纹理数据、区域、目标层和级别）在 desc 中描述。

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

将上传纹理 tex 层 0 级别 0 的 0 级别图像数据的更新任务加入队列。

tex 必须有一个非压缩格式。它的格式还必须与 image 的 QImage::format() 兼容。源数据在 image 中给出。