QRhiTexture Class

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512));
if (!texture->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
QImage image(512, 512, QImage::Format_RGBA8888);
image.fill(Qt::green);
batch->uploadTexture(texture, image);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

// determine newSize, e.g. based on the swapchain's output size or other factors
if (texture->pixelSize() != newSize) {
    texture->setPixelSize(newSize);
    if (!texture->create()) { error(); }
}
// continue using texture, fill it with new data

Documentación de las funciones miembro

int QRhiTexture::arrayRangeLength() const

Devuelve el tamaño del rango de array expuesto cuando se llamó a setArrayRange().

Véase también setArrayRange().

int QRhiTexture::arrayRangeStart() const

Devuelve la primera capa del array cuando se llamó a setArrayRange().

Véase también setArrayRange().

int QRhiTexture::arraySize() const

Devuelve el tamaño del array de texturas.

Véase también setArraySize().

[pure virtual] bool QRhiTexture::create()

Crea los recursos gráficos nativos correspondientes. Si ya hay recursos presentes debido a un create() anterior sin destroy() correspondiente, entonces destroy() se llama implícitamente primero.

Devuelve true en caso de éxito, false en caso de fallo de la operación gráfica. Independientemente del valor de retorno, la llamada a destroy() es siempre segura.

[virtual] bool QRhiTexture::createFrom(QRhiTexture::NativeTexture src)

Similar a create(), excepto que no se crean nuevas texturas nativas. En su lugar, se utilizan los recursos de texturas nativas especificados por src.

Esto permite importar un objeto de textura nativa existente (que debe pertenecer al mismo dispositivo o contexto de compartición, dependiendo de la API gráfica) desde un motor gráfico externo.

Devuelve true si el objeto de textura nativa existente especificado ha sido envuelto con éxito como un QRhiTexture no propietario.

Lo contrario de esta operación, exponer un objeto de textura nativo creado en QRhiTexture a un motor externo, es posible a través de nativeTexture().

int QRhiTexture::depth() const

Devuelve la profundidad de las texturas 3D.

Véase también setDepth().

QRhiTexture::Flags QRhiTexture::flags() const

Devuelve las banderas de textura.

Véase también setFlags().

QRhiTexture::Format QRhiTexture::format() const

Devuelve el formato de la textura.

Véase también setFormat().

[virtual] QRhiTexture::NativeTexture QRhiTexture::nativeTexture()

Devuelve los recursos nativos subyacentes para esta textura. El valor devuelto estará vacío si la exposición de los recursos nativos subyacentes no está soportada por el backend.

Véase también createFrom().

QSize QRhiTexture::pixelSize() const

Devuelve el tamaño en píxeles.

Véase también setPixelSize().

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::readViewFormat() const

Devuelve el formato de vista utilizado al muestrear la textura. Cuando no se llama, se asume que el formato de vista es el mismo que format().

Esta función se introdujo en Qt 6.8.

Véase también setReadViewFormat().

[override virtual] QRhiResource::Type QRhiTexture::resourceType() const

Reimplementa: QRhiResource::resourceType() const.

Devuelve el tipo de recurso.

int QRhiTexture::sampleCount() const

Devuelve el número de muestras. 1 significa que no hay antialiasing multimuestra.

Véase también setSampleCount().

void QRhiTexture::setArrayRange(int startIndex, int count)

Normalmente todas las capas del array están expuestas y depende del shader seleccionar la capa a través de la tercera coordenada pasada a la función GLSL texture() cuando se muestrea el sampler2DArray. Cuando QRhi::TextureArrayRange es reportado como soportado, llamar a setArrayRange() antes de create() o createFrom() solicita seleccionar sólo el rango especificado, count elementos comenzando desde startIndex. La lógica del shader puede entonces ser escrita con esto en mente.

Véase también QRhi::TextureArrayRange.

void QRhiTexture::setArraySize(int arraySize)

Establece la textura arraySize.

Véase también arraySize().

void QRhiTexture::setDepth(int depth)

Establece el depth para una textura 3D.

Véase también depth().

void QRhiTexture::setFlags(QRhiTexture::Flags f)

Establece las banderas de textura en f.

Véase también flags().

void QRhiTexture::setFormat(QRhiTexture::Format fmt)

Establece el formato de textura solicitado en fmt.

Véase también format().

[virtual] void QRhiTexture::setNativeLayout(int layout)

Con algunas APIs de gráficos, como Vulkan, la integración de código de renderizado personalizado que utiliza la API de gráficos directamente necesita un cuidado especial cuando se trata de diseños de imagen. Esta función permite comunicar el layout esperado en el que se encuentra la imagen que respalda el QRhiTexture después de los comandos de renderizado nativo.

Por ejemplo, considere renderizar en una QRhiTexture's VkImage directamente con Vulkan en un bloque de código encerrado por QRhiCommandBuffer::beginExternal() y QRhiCommandBuffer::endExternal(), seguido por el uso de la imagen para el muestreo de texturas en un QRhi-based render pass. Para evitar transiciones de disposición de imagen potencialmente incorrectas, esta función puede utilizarse para indicar cuál será la disposición de la imagen una vez completados los comandos grabados en dicho bloque de código.

Llamar a esta función sólo tiene sentido después de QRhiCommandBuffer::endExternal() y antes de un posterior QRhiCommandBuffer::beginPass().

Esta función no tiene efecto con backends QRhi donde la API gráfica subyacente no expone un concepto de disposición de imágenes.

void QRhiTexture::setPixelSize(const QSize &sz)

Establece el tamaño de la textura, especificado en píxeles, en sz.

Véase también pixelSize().

[since 6.8] void QRhiTexture::setReadViewFormat(const QRhiTexture::ViewFormat &fmt)

Establece el formato de vista del recurso shader (o el formato de la vista utilizada para el muestreo de la textura) a fmt. Por defecto se utiliza el mismo formato (y sRGB-ness) que la propia textura, y en la mayoría de los casos no es necesario llamar a esta función.

Esta configuración sólo se tiene en cuenta cuando se informa de que la función QRhi::TextureViewFormat es compatible.

Esta función se introdujo en Qt 6.8.

Véase también readViewFormat().

void QRhiTexture::setSampleCount(int s)

Establece el recuento de muestras en s.

Véase también sampleCount().

[since 6.8] void QRhiTexture::setWriteViewFormat(const QRhiTexture::ViewFormat &fmt)

Establece el formato de vista de destino de renderizado en fmt. Por defecto se utiliza el mismo formato (y sRGB-ness) que la propia textura, y en la mayoría de los casos no es necesario llamar a esta función.

Un caso de uso común para proporcionar un formato de vista de escritura es trabajar con texturas proporcionadas externamente que, fuera de nuestro control, utilizan un formato sRGB con APIs 3D como Vulkan o Direct 3D, pero el motor de renderizado ya está preparado para manejar la linealización y la conversión a sRGB al final de su pipeline de sombreado. En este caso lo que se busca al renderizar en una textura de este tipo es una vista de destino de render (por ejemplo, VkImageView) que tenga el mismo formato, pero no RGB. (si por ejemplo de una implementación OpenXR se obtiene una textura VK_FORMAT_R8G8B8A8_SRGB, es probable que el renderizado en ella deba hacerse usando una vista VK_FORMAT_R8G8B8A8_UNORM, si eso es lo que requiere el canal del motor de renderizado; en este ejemplo se llamaría a esta función con un ViewFormat que tenga un formato de QRhiTexture::RGBA8 y srgb ajustado a false).

Esta configuración sólo se tiene en cuenta cuando se informa de que la función QRhi::TextureViewFormat es compatible.

Esta función se introdujo en Qt 6.8.

Véase también writeViewFormat().

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::writeViewFormat() const

Devuelve el formato de vista usado cuando se escribe en la textura y cuando se usa con carga/almacenamiento de imagen. Cuando no se llama, se asume que el formato de vista es el mismo que format().

Esta función se introdujo en Qt 6.8.

Véase también setWriteViewFormat().