QRhiResourceUpdateBatch Class

Documentación de las funciones miembro

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

Coloca en cola una operación de copia de textura a textura desde src a dst como se describe en desc.

void QRhiResourceUpdateBatch::generateMips(QRhiTexture *tex)

Pone en cola una operación de generación de mipmap para la textura especificada tex.

Se admiten texturas 2D y cúbicas.

bool QRhiResourceUpdateBatch::hasOptimalCapacity() const

Devuelve verdadero hasta que el número de operaciones de búfer y textura en cola en este lote esté por debajo de un límite razonable.

El valor de retorno es false cuando el número de operaciones de búfer y/o textura añadidas a este lote han alcanzado, o están a punto de alcanzar, un cierto límite. El lote es completamente funcional después también, pero puede necesitar asignar memoria adicional. Por lo tanto, un renderizador que recoge muchas actualizaciones de búfer y textura en un solo lote cuando prepara un fotograma puede querer considerar submitting the batch y starting a new one cuando esta función devuelva false.

void QRhiResourceUpdateBatch::merge(QRhiResourceUpdateBatch *other)

Copia todas las operaciones en cola del lote other en éste.

Esto permite un patrón conveniente donde las actualizaciones de recursos que ya se conocen durante el paso de inicialización se recogen en un lote que luego se fusiona en otro cuando se inicia el primer pase de renderizado más adelante:

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)

Pone en cola la lectura de una región de QRhiBuffer buf . El tamaño de la región se especifica en size en bytes, offset es el offset en bytes desde el que empezar a leer.

Una relectura es asíncrona. result contiene una llamada de retorno que se invoca cuando la operación ha finalizado. Los datos se proporcionan en QRhiReadbackResult::data. Si la operación se completa con éxito, QByteArray tendrá un tamaño igual a size. En caso de fallo, QByteArray estará vacío.

Véase también readBackTexture(), QRhi::isFeatureSupported() y QRhi::resourceLimit().

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

Coloca en cola una operación de copia de textura a host como se describe en rb.

Normalmente rb especificará un QRhiTexture como fuente. Sin embargo, cuando el swapchain en el frame actual fue creado con QRhiSwapChain::UsedAsTransferSource, también puede ser la fuente de la readback. Para ello, deje la textura en null en rb.

A diferencia de otras operaciones, aquí los resultados deben ser procesados por la aplicación. Por lo tanto, result proporciona no sólo los datos, sino también una llamada de retorno, ya que las operaciones en el lote son asíncronas por naturaleza:

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);

Una única operación de readback copia un nivel mip de una capa (cara de cubemap o corte 3D o elemento de matriz de textura) cada vez. El nivel y la capa se especifican en los campos respectivos de rb.

Véase también readBackBuffer() y QRhi::resourceLimit().

void QRhiResourceUpdateBatch::release()

Devuelve el lote al pool. Esto sólo debería usarse cuando el lote no se pasa a uno de QRhiCommandBuffer::beginPass(), QRhiCommandBuffer::endPass(), o QRhiCommandBuffer::resourceUpdate() porque estos llaman implícitamente a destroy().

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

Encarga la actualización de una región de un QRhiBuffer buf creado con el tipo QRhiBuffer::Dynamic.

La región se especifica offset y size. Los bytes reales a escribir son especificados por data que debe tener al menos size bytes disponibles.

data es copiado y puede ser destruido o cambiado con seguridad una vez que esta función retorna.

[since 6.10] void QRhiResourceUpdateBatch::updateDynamicBuffer(QRhiBuffer *buf, quint32 offset, QByteArray data)

Encarga la actualización de una región de un QRhiBuffer buf creado con el tipo QRhiBuffer::Dynamic.

data se mueve al lote en lugar de copiarse con esta sobrecarga.

Esta función se introdujo en Qt 6.10.

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

Encarga la actualización de una región de un QRhiBuffer buf creado con el tipo QRhiBuffer::Immutable o QRhiBuffer::Static.

La región se especifica offset y size. Los bytes reales a escribir son especificados por data que debe tener al menos size bytes disponibles.

data es copiado y puede ser destruido o cambiado con seguridad una vez que esta función retorna.

[since 6.10] void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, QByteArray data)

Pone en cola la actualización completa de QRhiBuffer buf creada con el tipo QRhiBuffer::Immutable o QRhiBuffer::Static.

data se mueve al lote en lugar de copiarse con esta sobrecarga.

data size debe ser igual al tamaño de buf.

Esta función se introdujo en Qt 6.10.

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

Pone en cola la actualización de todo el QRhiBuffer buf creado con el tipo QRhiBuffer::Immutable o QRhiBuffer::Static.

[since 6.10] void QRhiResourceUpdateBatch::uploadStaticBuffer(QRhiBuffer *buf, quint32 offset, QByteArray data)

Encarga la actualización de una región de un QRhiBuffer buf creado con el tipo QRhiBuffer::Immutable o QRhiBuffer::Static.

data se mueve al lote en lugar de copiarse con esta sobrecarga.

Esta función se introdujo en Qt 6.10.

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

Encarga la carga de los datos de imagen para el nivel mip 0 de la capa 0 de la textura tex.

tex debe tener un formato sin comprimir. Su formato también debe ser compatible con el QImage::format() de image. Los datos de origen se dan en image.

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

Pone en cola la carga de los datos de imagen para uno o más niveles mip en una o más capas de la textura tex.

Los detalles de la copia (fuente QImage o datos de textura comprimidos, regiones, capas y niveles de destino) se describen en desc.