QSGRenderNode::RenderState Struct
struct QSGRenderNode::RenderStateFournit des informations sur la matrice de projection et le découpage. En savoir plus...
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 destinées au moteur de rendu lors de l'appel de commandes vers les backends du graphe de scène.
Voir également QSGRenderNode::render().
Documentation des fonctions membres
[pure virtual] const QRegion *RenderState::clipRegion() const
Renvoie la région de découpe actuelle ou la valeur null pour les backends où la découpe est implémentée via un stencil ou un « scissoring ».
Le backend software n’utilise ni projection, ni « scissor », ni « stencil », ce qui signifie que la majeure partie de l’état de rendu n’est pas utilisée. Cependant, la région de découpage pouvant être définie sur l’ QPainter doit tout de même être communiquée, car il n’est pas raisonnable de la reconstruire manuellement dans render(). Elle peut donc être interrogée via cette fonction. La région est exprimée en coordonnées mondiales et peut être transmise à QPainter::setClipRegion() avec Qt::ReplaceClip. Cela doit être effectué avant d’appeler QPainter::setTransform(), car la région de découpe 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 de type « state ».
Réservé à un usage futur.
[pure virtual] const QMatrix4x4 *RenderState::projectionMatrix() const
Renvoie un pointeur vers la matrice de projection actuelle.
La matrice modèle-vue peut être récupérée à l'aide de la fonction ` QSGRenderNode::matrix()`. En général, ` projection * modelview ` est la matrice qui est ensuite utilisée dans le shader de sommets pour transformer les sommets.
[pure virtual] bool RenderState::scissorEnabled() const
Renvoie l'état actuel du mode « scissoring ».
Remarque : ne s'appliquequ'aux API graphiques disposant d'un état activé/désactivé dédié pour le mode « scissoring ».
[pure virtual] QRect RenderState::scissorRect() const
Renvoie le rectangle de découpe actuel lorsque le découpage est activé. x et y correspondent aux coordonnées du coin inférieur gauche.
[pure virtual] bool RenderState::stencilEnabled() const
Renvoie l'état actuel du test de stencil.
Remarque : avec les API graphiques où le test de stencil est activé dans les objets d’état du pipeline, plutôt que par des commandes individuelles de définition d’état, il appartient à l’implémentation de ` render()` d’activer le test de stencil 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 le découpage est activé.
© 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.
