QSSGRhiContext Class

Documentation sur les fonctions membres

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

Permet de régler les modes de mosaïquage et de filtrage de ` samplerDescription` en fonction de la taille en pixels de ` texture`.

Dans la plupart des cas, samplerDescription n’est pas modifié. Cependant, avec les anciennes API 3D héritées, il est possible que les modes de mosaïquage tels que QRhiSampler::Repeat ne soient pas pris en charge pour les textures dont la largeur ou la hauteur n’est pas une puissance de deux.

Cette fonction pratique permet de créer des applications robustes, capables de fonctionner même lorsque des fonctionnalités telles que QRhi::NPOTTextureRepeat ne sont pas prises en charge par une implémentation d’OpenGL ES 2.0 ou de WebGL 1 au moment de l’exécution.

QRhiCommandBuffer *QSSGRhiContext::commandBuffer() const

Renvoie le tampon de commandes de l'image actuelle utilisé par le moteur de rendu 3D « Qt Quick ».

QRhiCommandBuffer::BeginPassFlags QSSGRhiContext::commonPassFlags() const

Renvoie les indicateurs recommandés lors de l'appel de la fonction ` QRhiCommandBuffer::beginPass()`.

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

Renvoie une texture dont l'flags et l'size des pixels sont celles spécifiées.

Cette fonction est destinée à permettre d’accéder efficacement à une texture « factice » remplie d’une fillColor donnée, et réutilisée à divers endroits dans la pile de rendu.

rub QRhiResourceUpdateBatch doit être valide, car cette fonction créera une nouvelle texture et générera son contenu si aucun objet mis en cache ne correspond. Les opérations de chargement nécessaires sont ensuite mises en file d’attente dans ce lot de mise à jour donné.

Lorsque arraySize est égal à 2 ou plus, un tableau de textures 2D est renvoyé.

La propriété de la texture renvoyée reste celle de Qt Quick 3D.

bool QSSGRhiContext::isValid() const

Renvoie « true » si le moteur de rendu a été initialisé avec succès.

int QSSGRhiContext::mainPassSampleCount() const

Renvoie le nombre d'échantillons utilisé lors du passage de rendu principal.

int QSSGRhiContext::mainPassViewCount() const

Renvoie le nombre de vues multiples utilisé lors du passage de rendu principal. Cette valeur est soit 2, lorsque le rendu multivue est activé, soit 1 (pas de rendu multivue).

QRhiRenderPassDescriptor *QSSGRhiContext::mainRenderPassDescriptor() const

Renvoie l'objet ` QRhiRenderPassDescriptor ` utilisé par le passage de rendu principal du moteur de rendu 3D ` Qt Quick `.

QRhiRenderTarget *QSSGRhiContext::renderTarget() const

Renvoie la cible de rendu utilisée par le moteur de rendu 3D de l'Qt Quick pour son passage de rendu principal dans l'image actuelle.

Il peut s’agir d’une cible de rendu issue d’une chaîne d’échange (swapchain), si l’ View3D utilise un mode de rendu (renderMode) autre que « Offscreen ». Le plus souvent, la cible de rendu fait référence à une texture (c’est-à-dire qu’il s’agit d’une « QRhiTextureRenderTarget »), par exemple parce que le mode de rendu par défaut est « Offscreen », ou parce que des effets de post-traitement sont utilisés.

QRhi *QSSGRhiContext::rhi() const

Renvoie l'objet ` QRhi ` utilisé par le moteur de rendu 3D ` Qt Quick `.

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

Renvoie un échantillonneur avec les modes de filtrage et de mosaïquage spécifiés dans ` samplerDescription`.

Les objets « QRhiSampler » générés sont mis en cache et réutilisés. Il s’agit donc d’un moyen pratique d’accéder à un « QRhiSampler » avec les paramètres indiqués, sans avoir à créer à chaque fois un nouvel objet dédié.

La propriété de l’ QRhiSampler renvoyé reste celle d’ Qt Quick 3D.