En esta página

QRhiTextureUploadDescription Class

Describe una operación de carga de texturas. Más información...

Encabezado: #include <rhi/qrhi.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)
target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)
qmake: QT += gui-private
Desde: Qt 6.6

Funciones públicas

QRhiTextureUploadDescription()
QRhiTextureUploadDescription(const QRhiTextureUploadEntry &entry)
QRhiTextureUploadDescription(std::initializer_list<QRhiTextureUploadEntry> list)
const QRhiTextureUploadEntry *cbeginEntries() const
const QRhiTextureUploadEntry *cendEntries() const
const QRhiTextureUploadEntry *entryAt(qsizetype index) const
qsizetype entryCount() const
void setEntries(std::initializer_list<QRhiTextureUploadEntry> list)
void setEntries(InputIterator first, InputIterator last)

Descripción detallada

Se utiliza con QRhiResourceUpdateBatch::uploadTexture(). Esa función tiene dos variantes: una que toma un QImage y otra que toma un QRhiTextureUploadDescription. La primera es una versión simplificada que, internamente, crea un QRhiTextureUploadDescription con una única imagen dirigida al nivel 0 para la capa 0.

Un ejemplo del caso común y sencillo en el que se desea cargar 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 cúbicos, imágenes mip pregeneradas, texturas comprimidas o subidas parciales, las aplicaciones tendrán que utilizar esta clase en su lugar.

QRhiTextureUploadDescription también permite especificar subidas por lotes, lo cual resulta útil, por ejemplo, al generar un atlas o una textura de caché de glifos: Se admiten varias subidas parciales para un mismo subrecurso (es decir, la misma capa y el mismo nivel) y, dependiendo del backend y de la API gráfica subyacente, pueden resultar más eficientes si se agrupan en el mismo `QRhiTextureUploadDescription` en lugar de emitir comandos individuales ` uploadTexture()` para cada una de ellas.

Nota: Los cubemaps tienen una capa para cada una de las seis caras en el orden +X, -X, +Y, -Y, +Z, -Z.

Por ejemplo, la especificación de 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);

En el caso de cargas parciales dirigidas al mismo subrecurso, 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);

Nota: Se trata de una API de RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.

Véase también QRhiResourceUpdateBatch.

Documentación de funciones miembro

[constexpr noexcept default] QRhiTextureUploadDescription::QRhiTextureUploadDescription()

Crea una descripción vacía para la subida de una textura.

QRhiTextureUploadDescription::QRhiTextureUploadDescription(const QRhiTextureUploadEntry &entry)

Crea una descripción de carga de textura con una única carga de subrecurso descrita en entry.

QRhiTextureUploadDescription::QRhiTextureUploadDescription(std::initializer_list<QRhiTextureUploadEntry> list)

Crea una descripción de carga de textura con el « list » de entradas especificado.

Nota: ` list ` también puede contener varios elementos ` QRhiTextureUploadEntry ` con la misma capa y el mismo nivel. Esto tiene sentido cuando esas subidas son parciales, es decir, cuando la descripción de su subrecurso tiene un tamaño de origen o una imagen menor que las dimensiones del subrecurso, y puede resultar más eficiente que llamar a varias funciones `uploadTexture()` por separado.

const QRhiTextureUploadEntry *QRhiTextureUploadDescription::cbeginEntries() const

Devuelve un iterador const que apunta al primer elemento de la lista de entradas.

const QRhiTextureUploadEntry *QRhiTextureUploadDescription::cendEntries() const

Devuelve un iterador const que apunta justo después del último elemento de la lista de entradas.

const QRhiTextureUploadEntry *QRhiTextureUploadDescription::entryAt(qsizetype index) const

Devuelve la entrada de index.

qsizetype QRhiTextureUploadDescription::entryCount() const

Devuelve el número de entradas.

void QRhiTextureUploadDescription::setEntries(std::initializer_list<QRhiTextureUploadEntry> list)

Establece el valor de « list » de las entradas.

template <typename InputIterator> void QRhiTextureUploadDescription::setEntries(InputIterator first, InputIterator last)

Establece la lista de entradas utilizando los iteradores first y last.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.