Sur cette page

QSGOpacityNode Class

La classe QSGOpacityNode permet de modifier l'opacité des nœuds. En savoir plus...

En-tête : #include <QSGOpacityNode>
CMake : find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake : QT += quick
Hérite de : QSGNode

Fonctions publiques

QSGOpacityNode()
virtual ~QSGOpacityNode() override
qreal opacity() const
void setOpacity(qreal opacity)

Description détaillée

L'opacité s'applique à sa sous-arborescence et peut être imbriquée. Les nœuds d'opacité multiples seront cumulés en multipliant leurs opacités respectives. Ce cumul s'effectue lors du rendu.

Lorsque l’opacité imbriquée passe en dessous d’un certain seuil, la sous-arborescence peut être marquée comme bloquée, ce qui entraîne le retour de la valeur « true » par la fonction ` isSubtreeBlocked()`. Cette mesure est prise pour des raisons de performances.

Remarque : toutes les classes portant le préfixe QSG doivent être utilisées exclusivement sur le thread de rendu du graphe de scène. Voir Graphe de scène et rendu pour plus d’informations.

Documentation des fonctions membres

QSGOpacityNode::QSGOpacityNode()

Crée un nœud d'opacité avec une opacité par défaut de 1.

L’opacité s’accumule vers le bas dans l’arborescence de la scène ; ainsi, un nœud surmonté de deux instances de QSGOpacityNode, toutes deux avec une opacité de 0,5, aura une opacité effective de 0,25.

L'opacité par défaut des nœuds est de 1.

[override virtual noexcept] QSGOpacityNode::~QSGOpacityNode()

Supprime le nœud d’opacité.

qreal QSGOpacityNode::opacity() const

Renvoie l'opacité de ce nœud d'opacité.

Voir aussi setOpacity().

void QSGOpacityNode::setOpacity(qreal opacity)

Définit l'opacité de ce nœud sur opacity.

Avant de générer le graphique, le moteur de rendu effectuera un passage de mise à jour sur la sous-arborescence afin de propager l'opacité à ses enfants.

La valeur sera comprise entre 0 et 1.

Voir également opacity().

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