QRhiTextureUploadDescription Class

Detaillierte Beschreibung

Wird mit „ QRhiResourceUpdateBatch::uploadTexture()“ verwendet. Diese Funktion verfügt über zwei Varianten: eine, die ein „ QImage “ akzeptiert, und eine, die ein „QRhiTextureUploadDescription“ akzeptiert. Die erstere ist eine Komfortversion, die intern ein „QRhiTextureUploadDescription“ mit einem einzelnen Bild erstellt, das auf Ebene 0 für Ebene 0 abzielt.

Ein Beispiel für den gängigen, einfachen Fall, bei dem der Inhalt eines ` QImage ` in ein ` QRhiTexture ` mit passender Pixelgröße hochgeladen werden soll:

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

Wenn es sich um Cubemaps, vorgefertigte Mip-Bilder, komprimierte Texturen oder Teil-Uploads handelt, müssen Anwendungen stattdessen diese Klasse verwenden.

QRhiTextureUploadDescription ermöglicht zudem die Festlegung von gebündelten Uploads, die beispielsweise bei der Erstellung einer Atlas- oder Glyphen-Cache-Textur nützlich sind: Mehrere Teil-Uploads für dieselbe Subressource (d. h. dieselbe Ebene und denselben Level) werden unterstützt und können – je nach Backend und zugrunde liegender Grafik-API – effizienter sein, wenn sie in derselben `QRhiTextureUploadDescription` gebündelt werden, anstatt für jeden einzelnen den Befehl ` uploadTexture()` auszuführen.

Die Angabe der Flächen einer Cubemap könnte beispielsweise wie folgt aussehen:

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

Ein weiteres Beispiel, das Mip-Bilder für eine komprimierte Textur festlegt:

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

Bei Teil-Uploads, die auf dieselbe Subressource abzielen, wird empfohlen, diese nach Möglichkeit in einer einzigen Upload-Anfrage zu bündeln:

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