QSSGRhiContext Class

Documentación de las funciones de los miembros

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

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

En la mayoría de los casos, samplerDescription no se modifica. Sin embargo, si se utilizan API 3D antiguas, existe la posibilidad de que los modos de mosaico como QRhiSampler::Repeat no sean compatibles con texturas cuya anchura o altura no sean potencias de dos.

Esta conveniente función ayuda a crear aplicaciones robustas que pueden seguir funcionando incluso cuando características como QRhi::NPOTTextureRepeat no son soportadas por una implementación 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 renderizador 3D de Qt Quick.

QRhiCommandBuffer::BeginPassFlags QSSGRhiContext::commonPassFlags() const

Devuelve Las banderas recomendadas al llamar a 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 que tiene el flags especificado y el píxel size.

Esto está pensado para acceder eficientemente a una textura "ficticia" rellenada con un fillColor dado, y reutilizada en varios lugares de la pila de renderizado.

rub debe ser un QRhiResourceUpdateBatch válido, ya que esta función creará una nueva textura y generará contenido para ella, si no se encuentra un objeto en caché adecuado. 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 un array de texturas 2D.

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

bool QSSGRhiContext::isValid() const

Devuelve true si el renderizador se ha inicializado correctamente.

int QSSGRhiContext::mainPassSampleCount() const

Devuelve el recuento de muestras utilizado en el pase de renderizado principal.

int QSSGRhiContext::mainPassViewCount() const

Devuelve el número de vistas múltiples utilizadas en el pase de renderizado principal. Puede ser 2, cuando se utiliza el renderizado multivista, o 1 (sin multivista).

QRhiRenderPassDescriptor *QSSGRhiContext::mainRenderPassDescriptor() const

Devuelve El QRhiRenderPassDescriptor utilizado por el pase de renderizado principal del renderizador 3D Qt Quick.

QRhiRenderTarget *QSSGRhiContext::renderTarget() const

Devuelve El objetivo de renderizado que el renderizador 3D de Qt Quick utiliza para su pase de renderizado principal en el fotograma actual.

Puede ser un objetivo de renderizado de una swapchain, si View3D utiliza un renderMode distinto de Offscreen. Más comúnmente, el objetivo de renderizado se refiere a una textura (es decir, es un QRhiTextureRenderTarget), por ejemplo, porque el renderMode es el predeterminado Offscreen, o porque se están utilizando efectos de post-procesamiento.

QRhi *QSSGRhiContext::rhi() const

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

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

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

Los objetos QRhiSampler generados se almacenan en caché y se reutilizan. Por lo tanto, esta es una forma cómoda de acceder a un QRhiSampler con la configuración dada, sin tener que crear un objeto nuevo y dedicado todo el tiempo.

La propiedad del QRhiSampler devuelto permanece en Qt Quick 3D.