Sur cette page

QSGRenderNode::RenderState Struct

struct QSGRenderNode::RenderState

Fournit des informations sur la matrice de projection et l'écrêtage. Plus d'informations...

Fonctions publiques

virtual const QRegion *clipRegion() const = 0
virtual void *get(const char *state) const
virtual const QMatrix4x4 *projectionMatrix() const = 0
virtual bool scissorEnabled() const = 0
virtual QRect scissorRect() const = 0
virtual bool stencilEnabled() const = 0
virtual int stencilValue() const = 0

Description détaillée

L'état de rendu contient des informations pour le moteur de rendu lors de l'invocation de commandes aux backends de la scène.

Voir aussi QSGRenderNode::render().

Documentation des fonctions membres

[pure virtual] const QRegion *RenderState::clipRegion() const

Renvoie la région d'écrêtage actuelle ou null pour les backends où l'écrêtage est implémenté via un pochoir ou un ciseau.

Le backend software n'utilise pas de projection, de ciseaux ou de pochoir, ce qui signifie que la majeure partie de l'état de rendu n'est pas utilisée. Cependant, la région d'écrêtage qui peut être définie sur le site QPainter doit toujours être communiquée, car sa reconstruction manuelle dans render() n'est pas raisonnable. Cette fonction permet donc de l'interroger. La région est en coordonnées mondiales et peut être transmise à QPainter::setClipRegion() avec Qt::ReplaceClip. Cela doit être fait avant d'appeler QPainter::setTransform() puisque la région du clip est déjà mappée à la transformation fournie dans QSGRenderNode::matrix().

[virtual] void *RenderState::get(const char *state) const

Renvoie un pointeur vers une valeur state.

Réservé pour une utilisation future.

[pure virtual] const QMatrix4x4 *RenderState::projectionMatrix() const

Renvoie le pointeur sur la matrice de projection actuelle.

La matrice modèle-vue peut être récupérée avec QSGRenderNode::matrix(). Généralement, projection * modelview est la matrice qui est ensuite utilisée dans le vertex shader pour transformer les sommets.

[pure virtual] bool RenderState::scissorEnabled() const

Renvoie l'état actuel des ciseaux.

Remarque : cette fonction n'est utile que pour les API graphiques qui disposent d'un état d'activation/désactivation des ciseaux.

[pure virtual] QRect RenderState::scissorRect() const

Renvoie le rectangle de ciseaux actuel lorsque le découpage est actif. x et y sont les coordonnées en bas à gauche.

[pure virtual] bool RenderState::stencilEnabled() const

Renvoie l'état actuel du test des pochoirs.

Remarque : avec les API graphiques où le test des pochoirs est activé dans les objets d'état du pipeline, au lieu de commandes individuelles de réglage de l'état, il appartient à l'implémentation de render() d'activer le test des pochoirs avec les opérations KEEP, la fonction de comparaison EQUAL, et un masque de lecture et d'écriture de 0xFF.

[pure virtual] int RenderState::stencilValue() const

Renvoie la valeur de référence actuelle du pochoir lorsque l'écrêtage est actif.

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