QSSGRhiContext Class

Documentation des fonctions membres

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

Ajuste les modes de pavage et de filtrage de samplerDescription en fonction de la taille des pixels de texture.

Dans la plupart des cas, samplerDescription n'est pas modifié. Avec les anciennes API 3D utilisées, il est toutefois possible que les modes de tuilage 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 de commodité aide à créer des applications robustes qui peuvent toujours fonctionner même lorsque des caractéristiques telles que QRhi::NPOTTextureRepeat ne sont pas supportées par une implémentation OpenGL ES 2.0 ou WebGL 1 au moment de l'exécution.

QRhiCommandBuffer *QSSGRhiContext::commandBuffer() const

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

QRhiCommandBuffer::BeginPassFlags QSSGRhiContext::commonPassFlags() const

Retourne les drapeaux recommandés lors de l'appel à 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 ayant le flags et le pixel size spécifiés.

Cela permet d'accéder efficacement à une texture "factice" remplie avec un fillColor donné et réutilisée à divers endroits de la pile de rendu.

rub doit être un QRhiResourceUpdateBatch valide puisque cette fonction créera une nouvelle texture et générera du contenu pour elle, si un objet mis en cache approprié n'est pas trouvé. Les opérations de téléchargement nécessaires sont alors mises en file d'attente sur ce lot de mise à jour donné.

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

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

bool QSSGRhiContext::isValid() const

Retourne true si le moteur de rendu a été initialisé avec succès.

int QSSGRhiContext::mainPassSampleCount() const

Renvoie le nombre d'échantillons utilisés dans la passe de rendu principale.

int QSSGRhiContext::mainPassViewCount() const

Renvoie le nombre de vues multiples utilisé dans la passe de rendu principale. Il s'agit soit de 2, lorsque le rendu multivue est utilisé, soit de 1 (pas de multivue).

QRhiRenderPassDescriptor *QSSGRhiContext::mainRenderPassDescriptor() const

Retourne le site QRhiRenderPassDescriptor utilisé par la passe de rendu principale du moteur de rendu 3D Qt Quick.

QRhiRenderTarget *QSSGRhiContext::renderTarget() const

Renvoie la cible de rendu que le moteur de rendu 3D Qt Quick utilise pour sa passe de rendu principale dans l'image actuelle.

Il peut s'agir d'une cible de rendu provenant d'une chaîne d'échange, si View3D utilise un renderMode autre que Offscreen. Plus souvent, la cible de rendu fait référence à une texture (c'est-à-dire qu'il s'agit de QRhiTextureRenderTarget), par exemple parce que le renderMode est le mode Offscreen par défaut, ou parce que des effets de post-traitement sont en cours d'utilisation.

QRhi *QSSGRhiContext::rhi() const

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

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

Renvoie un échantillonneur avec le filtre et les modes de pavage 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 donnés, sans avoir à créer un nouvel objet dédié en permanence.

La propriété de l'objet QRhiSampler retourné reste celle de Qt Quick 3D.