En esta página

QRhiColorAttachment Class

Describe la asignación de un único color a un destino de renderizado. 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

QRhiColorAttachment()
QRhiColorAttachment(QRhiRenderBuffer *renderBuffer)
QRhiColorAttachment(QRhiTexture *texture)
int layer() const
int level() const
(since 6.7) int multiViewCount() const
QRhiRenderBuffer *renderBuffer() const
int resolveLayer() const
int resolveLevel() const
QRhiTexture *resolveTexture() const
void setLayer(int layer)
void setLevel(int level)
(since 6.7) void setMultiViewCount(int count)
void setRenderBuffer(QRhiRenderBuffer *rb)
void setResolveLayer(int layer)
void setResolveLevel(int level)
void setResolveTexture(QRhiTexture *tex)
void setTexture(QRhiTexture *tex)
QRhiTexture *texture() const

Descripción detallada

Un accesorio de color puede ser un ` QRhiTexture ` o un ` QRhiRenderBuffer`. El primero, es decir, cuando se establece ` texture()`, es el que se utiliza en la mayoría de los casos. `QRhiColorAttachment` se suele utilizar en combinación con ` QRhiTextureRenderTargetDescription`.

Nota: No es posible establecer simultáneamentetexture() y renderBuffer() (es decir, que ambos sean distintos de nulo al mismo tiempo).

Se recomienda establecer renderBuffer solo cuando se necesite multimuestreo. En la práctica, es mejor recurrir a QRhi::MultisampleRenderBuffer que a QRhi::MultisampleTexture, ya que el primero está disponible en más configuraciones de tiempo de ejecución (por ejemplo, al ejecutarse en OpenGL ES 3.0, que no admite texturas multimuestreadas, pero sí admite búferes de renderizado multimuestreados).

Cuando se utiliza una textura sin multimuestreo, las funciones ` layer()` y ` level()` indican la capa de destino (índice de cara ` 0-5 ` para los cubemaps) y el nivel de mip. Para las texturas 3D, ` layer()` especifica la sección (una imagen 2D dentro de la textura 3D) en la que se va a renderizar. Para las matrices de texturas, ` layer()` es el índice de la matriz.

Cuando texture() o renderBuffer() son de multimuestra, resolveTexture() se puede establecer de forma opcional. Si se establece, las muestras se resuelven automáticamente en esa textura (no multimuestra) al final de la pasada de renderizado. Al renderizar en búferes de renderizado multimuestra, esta es la única forma de obtener de ellos contenido resuelto y no multimuestra. Las texturas multimuestra permiten el muestreo en los shaders, por lo que para ellas esta es solo una opción más.

Nota: cuando la resolución está habilitada, es posible que los datos multimuestra no se escriban en absoluto. Esto significa que la textura multimuestra texture() no debe utilizarse posteriormente con sombreadores para el muestreo cuando se ha establecido resolveTexture().

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 QRhiTextureRenderTargetDescription.

Documentación de funciones miembro

[constexpr noexcept default] QRhiColorAttachment::QRhiColorAttachment()

Crea una descripción vacía de un archivo adjunto de color.

QRhiColorAttachment::QRhiColorAttachment(QRhiRenderBuffer *renderBuffer)

Crea una descripción de un accesorio de color que especifica renderBuffer como el búfer de color asociado.

QRhiColorAttachment::QRhiColorAttachment(QRhiTexture *texture)

Crea una descripción de un accesorio de color que especifica texture como el búfer de color asociado.

int QRhiColorAttachment::layer() const

Devuelve el índice de la capa (cara del mapa cúbico o capa de matriz). El valor por defecto es 0.

Véase también setLayer().

int QRhiColorAttachment::level() const

Devuelve el nivel de mip. El valor por defecto es 0.

Véase también setLevel().

[since 6.7] int QRhiColorAttachment::multiViewCount() const

Devuelve el número de vistas establecido actualmente. El valor por defecto es 0, lo que indica que el destino de renderizado con este adjunto de color no se va a utilizar en el renderizado multivista.

Esta función se introdujo en Qt 6.7.

Véase también ` setMultiViewCount()`.

QRhiRenderBuffer *QRhiColorAttachment::renderBuffer() const

Devuelve el búfer de renderizado al que hace referencia esta descripción de adjunto, o ` nullptr ` si no hay ninguno.

En la práctica, asociar un ` QRhiRenderBuffer ` con un ` QRhiColorAttachment ` tiene más sentido cuando se configura el renderizado multimuestra mediante un búfer de renderizado multimuestra ` color `, que luego se resuelve en una textura no multimuestra al final de la pasada de renderizado.

Véase también setRenderBuffer().

int QRhiColorAttachment::resolveLayer() const

Devuelve la capa de resolución de textura establecida actualmente. El valor por defecto es 0.

Véase también setResolveLayer().

int QRhiColorAttachment::resolveLevel() const

Devuelve el nivel de mip de la textura de resolución establecido actualmente. El valor por defecto es 0.

Véase también ` setResolveLevel()`.

QRhiTexture *QRhiColorAttachment::resolveTexture() const

Devuelve la textura de resolución a la que hace referencia esta descripción de adjunto, o ` nullptr ` si no hay ninguna.

El establecimiento de una textura de resolución distinta de nula es aplicable cuando el archivo adjunto hace referencia a una textura multimuestra o a un búfer de renderizado. En ese caso, el ` QRhiTexture ` de la función `resolveTexture()` es una textura 2D no multimuestra (o una matriz de texturas) del mismo tamaño (pero con un recuento de muestras igual a 1). El contenido multisample se resuelve automáticamente en esta textura al final de cada pasada de renderizado.

Véase también setResolveTexture().

void QRhiColorAttachment::setLayer(int layer)

Establece el índice « layer ».

Véase también layer().

void QRhiColorAttachment::setLevel(int level)

Establece el mip level.

Véase también level().

[since 6.7] void QRhiColorAttachment::setMultiViewCount(int count)

Establece la vista count. Si se establece un valor superior a 1, se indica que el destino de renderizado con este adjunto de color se va a utilizar con renderizado multivista. El valor por defecto es 0. Los valores inferiores a 2 indican que no se realiza renderizado multivista.

Cuando count se establece en 2 o un valor superior, el adjunto de color debe estar asociado a una matriz de texturas 2D. Las funciones layer() y multiViewCount() definen conjuntamente el rango de elementos de la matriz de texturas a los que se dirige el renderizado multivista.

Por ejemplo, si layer es 0 y multiViewCount es 2, la matriz de texturas debe tener 2 (o más) elementos, y el renderizado multivista se centrará en los elementos 0 y 1. La variable gl_ViewIndex en los shaders tendrá entonces un valor de 0 o 1, donde la vista 0 corresponde al elemento de la matriz de texturas 0, y la vista 1 al elemento de la matriz 1.

Nota: Establecer un valor de ` count ` superior a 1, utilizar una matriz de texturas como ` texture()` y llamar a ` beginPass()` en un ` QRhiTextureRenderTarget ` con este color adjunto implica un renderizado multivista para toda la pasada de renderizado. No se debe establecer ` multiViewCount()` a menos que se desee un renderizado multivista. La representación multivista no se puede utilizar con tipos de texturas distintos de las matrices de texturas 2D. (Aunque las texturas 3D pueden funcionar, dependiendo de la API gráfica y del backend; no obstante, se recomienda a las aplicaciones que no confíen en ello y que utilicen únicamente matrices de texturas 2D como destinos de renderizado de la representación multivista).

Consulte GL_OVR_multiview para obtener más detalles sobre el renderizado multivista. Tenga en cuenta que Qt también requiere GL_OVR_multiview2 cuando se ejecuta en OpenGL (ES).

El renderizado multivista solo está disponible cuando se indica que la función « MultiView » es compatible en isFeatureSupported().

Nota: Por motivos de portabilidad, ten en cuenta las limitaciones que existen para el renderizado multivista con algunas de las API gráficas. Se recomienda que las pasadas de renderizado multivista no dependan de ninguna de las características que GL_OVR_multiview declara como no compatibles. La única excepción son las salidas de la etapa de shader distintas de gl_Position según gl_ViewIndex: se puede confiar en ellas (incluso con OpenGL) porque QRhi nunca indica que se admite el renderizado multivista sin que también esté presente GL_OVR_multiview2.

Nota: El renderizadomultivista no es compatible con los sombreadores de teselación ni con los de geometría, aunque algunas implementaciones de ciertas API gráficas puedan permitirlo.

Esta función se introdujo en Qt 6.7.

Véase también multiViewCount().

void QRhiColorAttachment::setRenderBuffer(QRhiRenderBuffer *rb)

Establece el búfer de renderizado rb.

Nota: No es posible establecer a la veztexture() y renderBuffer() (es decir, que sean distintos de nulo al mismo tiempo).

Véase también renderBuffer().

void QRhiColorAttachment::setResolveLayer(int layer)

Establece la textura de resolución layer que se va a utilizar.

Véase también resolveLayer().

void QRhiColorAttachment::setResolveLevel(int level)

Establece el mip level e de la textura de resolución que se va a utilizar.

Véase también resolveLevel().

void QRhiColorAttachment::setResolveTexture(QRhiTexture *tex)

Establece la textura de resolución tex.

tex Se espera que sea una textura 2D o una matriz de texturas 2D. En ambos casos, la resolución se aplica a un único nivel MIP de una única capa (elemento de la matriz) de ` tex`. El nivel MIP y la capa de la matriz se especifican mediante ` resolveLevel()` y ` resolveLayer()`.

Una excepción es multiview: cuando el anexo de color está asociado a una matriz de texturas y la opción «multiview» está activada, la textura de resolución también debe ser una matriz de texturas con elementos suficientes para todas las vistas. En este caso, todos los elementos que corresponden a las vistas se resuelven automáticamente; el comportamiento es similar al siguiente pseudocódigo:

for (i = 0; i < multiViewCount(); ++i)
    resolve texture's layer() + i into resolveTexture's resolveLayer() + i

Establecer una textura no multimuestreada para resolver automáticamente una textura multimuestreada o un renderbuffer al final de la pasada de renderizado suele ser preferible a trabajar con texturas multimuestreadas (y no establecer una textura de resolución), ya que evita la necesidad de escribir shaders de fragmento específicos que funcionen exclusivamente con texturas multimuestreadas (sampler2DMS, texelFetch, etc.), y permite, en cambio, utilizar el mismo sombreador que se emplearía si la textura del anexo no fuera multisample desde el principio. Esto conlleva el gasto de un recurso adicional (el « tex » no multisample).

Véase también resolveTexture().

void QRhiColorAttachment::setTexture(QRhiTexture *tex)

Establece la textura « tex ».

Nota: No es posible establecer a la veztexture() y renderBuffer(es decir, que ambos sean distintos de nulo al mismo tiempo).

Véase también texture().

QRhiTexture *QRhiColorAttachment::texture() const

Devuelve la textura a la que hace referencia esta descripción de adjunto, o ` nullptr ` si no hay ninguna.

Véase también setTexture().

© 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.