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