QRhiTextureUploadDescription Class

Descripción detallada

Usada con QRhiResourceUpdateBatch::uploadTexture(). Esta función tiene dos variantes: una que toma un QImage y otra que toma un QRhiTextureUploadDescription. La primera es una versión de conveniencia, que crea internamente un QRhiTextureUploadDescription con una única imagen de nivel 0 para la capa 0.

Un ejemplo del caso común y simple de querer subir el contenido de un QImage a un QRhiTexture con un tamaño de píxel coincidente:

QImage image(256, 256, QImage::Format_RGBA8888);
image.fill(Qt::green); // or could use a QPainter targeting image
QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(256, 256));
texture->create();
QRhiResourceUpdateBatch *u = rhi->nextResourceUpdateBatch();
u->uploadTexture(texture, image);

Cuando se trate de mapas de cubos, imágenes mip pregeneradas, texturas comprimidas o cargas parciales, las aplicaciones tendrán que utilizar esta clase en su lugar.

QRhiTextureUploadDescription también permite especificar subidas por lotes, que son útiles por ejemplo cuando se genera un atlas o una textura de caché de glifos: múltiples subidas parciales para el mismo sub-recurso (es decir, la misma capa y nivel) son compatibles, y pueden ser, dependiendo del backend y la API gráfica subyacente, más eficientes cuando se agrupan en el mismo QRhiTextureUploadDescription en lugar de emitir comandos uploadTexture() individuales para cada uno de ellos.

Por ejemplo, especificar las caras de un cubemap podría tener el siguiente aspecto:

QImage faces[6];
// ...
QVarLengthArray<QRhiTextureUploadEntry, 6> entries;
for (int i = 0; i < 6; ++i)
  entries.append(QRhiTextureUploadEntry(i, 0, faces[i]));
QRhiTextureUploadDescription desc;
desc.setEntries(entries.cbegin(), entries.cend());
resourceUpdates->uploadTexture(texture, desc);

Otro ejemplo que especifica imágenes mip para una textura comprimida:

QList<QRhiTextureUploadEntry> entries;
const int mipCount = rhi->mipLevelsForSize(compressedTexture->pixelSize());
for (int level = 0; level < mipCount; ++level) {
    const QByteArray compressedDataForLevel = ..
    entries.append(QRhiTextureUploadEntry(0, level, compressedDataForLevel));
}
QRhiTextureUploadDescription desc;
desc.setEntries(entries.cbegin(), entries.cend());
resourceUpdates->uploadTexture(compressedTexture, desc);

Con cargas parciales dirigidas al mismo sub-recurso, se recomienda agruparlas en una única solicitud de carga, siempre que sea posible:

QRhiTextureSubresourceUploadDescription subresDesc(image);
subresDesc.setSourceSize(QSize(10, 10));
subResDesc.setDestinationTopLeft(QPoint(50, 40));
QRhiTextureUploadEntry entry(0, 0, subresDesc); // layer 0, level 0

QRhiTextureSubresourceUploadDescription subresDesc2(image);
subresDesc2.setSourceSize(QSize(30, 40));
subResDesc2.setDestinationTopLeft(QPoint(100, 200));
QRhiTextureUploadEntry entry2(0, 0, subresDesc2); // layer 0, level 0, i.e. same subresource

QRhiTextureUploadDescription desc({ entry, entry2});
resourceUpdates->uploadTexture(texture, desc);