En esta página

QSSGRhiContext Class

QSSGRhiContext. Más...

Header: #include <qssgrhicontext.h>
Since: Qt 6.7

Funciones públicas

void checkAndAdjustForNPoT(QRhiTexture *texture, QSSGRhiSamplerDescription *samplerDescription)
QRhiCommandBuffer *commandBuffer() const
QRhiCommandBuffer::BeginPassFlags commonPassFlags() const
QRhiTexture *dummyTexture(QRhiTexture::Flags flags, QRhiResourceUpdateBatch *rub, const QSize &size = QSize(64, 64), const QColor &fillColor = Qt::black, int arraySize = 0)
bool isValid() const
int mainPassSampleCount() const
int mainPassViewCount() const
QRhiRenderPassDescriptor *mainRenderPassDescriptor() const
QRhiRenderTarget *renderTarget() const
QRhi *rhi() const
QRhiSampler *sampler(const QSSGRhiSamplerDescription &samplerDescription)

Descripción detallada

Documentación de las funciones de miembro

void QSSGRhiContext::checkAndAdjustForNPoT(QRhiTexture *texture, QSSGRhiSamplerDescription *samplerDescription)

Ajusta los modos de mosaico y filtrado de « samplerDescription » en función del tamaño de píxel de « texture ».

En la mayoría de los casos, samplerDescription no se modifica. Sin embargo, cuando se utilizan API 3D antiguas y heredadas, existe la posibilidad de que los modos de mosaico, como QRhiSampler::Repeat, no sean compatibles con texturas cuyo ancho o alto no sea una potencia de dos.

Esta función de conveniencia ayuda a crear aplicaciones robustas que puedan seguir funcionando incluso cuando características como QRhi::NPOTTextureRepeat no sean compatibles con una implementación de OpenGL ES 2.0 o WebGL 1 en tiempo de ejecución.

QRhiCommandBuffer *QSSGRhiContext::commandBuffer() const

Devuelve el búfer de comandos del fotograma actual utilizado por el motor de renderizado 3D « Qt Quick ».

QRhiCommandBuffer::BeginPassFlags QSSGRhiContext::commonPassFlags() const

Devuelve los indicadores recomendados al llamar a la función « QRhiCommandBuffer::beginPass()».

QRhiTexture *QSSGRhiContext::dummyTexture(QRhiTexture::Flags flags, QRhiResourceUpdateBatch *rub, const QSize &size = QSize(64, 64), const QColor &fillColor = Qt::black, int arraySize = 0)

Devuelve una textura con el flags y el pixel size especificados.

El objetivo es obtener acceso de forma eficiente a una textura «ficticia» rellenada con un « fillColor » determinado y reutilizada en diversos puntos de la pila de renderizado.

rub QRhiResourceUpdateBatch debe ser válido, ya que esta función creará una nueva textura y generará contenido para ella si no se encuentra un objeto almacenado en caché adecuado. A continuación, las operaciones de carga necesarias se ponen en cola en este lote de actualización dado.

Cuando arraySize es 2 o más, se devuelve una matriz de texturas 2D.

La propiedad de la textura devuelta recae en Qt Quick 3D.

bool QSSGRhiContext::isValid() const

Devuelve «true» si el renderizador se ha inicializado correctamente.

int QSSGRhiContext::mainPassSampleCount() const

Devuelve el número de muestras utilizadas en la pasada de renderizado principal.

int QSSGRhiContext::mainPassViewCount() const

Devuelve el recuento de vistas múltiples utilizado en la pasada de renderizado principal. Este valor es 2, cuando se utiliza el renderizado con vistas múltiples, o 1 (sin vistas múltiples).

QRhiRenderPassDescriptor *QSSGRhiContext::mainRenderPassDescriptor() const

Devuelve el objeto ` QRhiRenderPassDescriptor ` utilizado por la pasada de renderizado principal del renderizador 3D ` Qt Quick `.

QRhiRenderTarget *QSSGRhiContext::renderTarget() const

Devuelve el destino de renderizado que utiliza el renderizador 3D « Qt Quick » para su pasada de renderizado principal en el fotograma actual.

En la práctica, puede tratarse de un destino de renderizado procedente de una cadena de intercambio (swapchain), si el « View3D » utiliza un modo de renderizado (renderMode) distinto de «Offscreen». Lo más habitual es que el destino de renderizado haga referencia a una textura (es decir, sea un objeto de textura de renderizado [ QRhiTextureRenderTarget]), por ejemplo, porque el modo de renderizado es el predeterminado «Offscreen» o porque se están utilizando efectos de posprocesamiento.

QRhi *QSSGRhiContext::rhi() const

Devuelve el objeto ` QRhi ` utilizado por el renderizador 3D ` Qt Quick `.

QRhiSampler *QSSGRhiContext::sampler(const QSSGRhiSamplerDescription &samplerDescription)

Devuelve un sampler con los modos de filtro y mosaico especificados en samplerDescription.

Los objetos « QRhiSampler » generados se almacenan en caché y se reutilizan. Por lo tanto, esta es una forma práctica de acceder a un « QRhiSampler » con la configuración indicada, sin tener que crear un nuevo objeto específico cada vez.

La propiedad del objeto ` QRhiSampler ` devuelto sigue perteneciendo a ` Qt Quick 3D`.

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