En esta página

QSGOpacityNode Class

La clase QSGOpacityNode se utiliza para cambiar la opacidad de los nodos. Más...

Cabecera: #include <QSGOpacityNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Hereda: QSGNode

Funciones Públicas

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

Descripción Detallada

La opacidad se aplica a su subárbol y puede anidarse. Múltiples nodos de opacidad serán acumulados multiplicando su opacidad. La acumulación ocurre como parte del renderizado.

Cuando la opacidad anidada se sitúa por debajo de un cierto umbral, el subárbol puede marcarse como bloqueado, haciendo que isSubtreeBlocked() devuelva true. Esto se hace por razones de rendimiento.

Nota: Todas las clases con el prefijo QSG deben utilizarse únicamente en el subproceso de renderizado del gráfico de escena. Ver Gráfico de Escena y Renderizado para más información.

Documentación de las funciones miembro

QSGOpacityNode::QSGOpacityNode()

Construye un nodo de opacidad con una opacidad por defecto de 1.

La opacidad se acumula hacia abajo en el gráfico de la escena, por lo que un nodo con dos instancias QSGOpacityNode por encima de él, ambas con una opacidad de 0.5, tendrá una opacidad efectiva de 0.25.

La opacidad por defecto de los nodos es 1.

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

Elimina el nodo de opacidad.

qreal QSGOpacityNode::opacity() const

Devuelve la opacidad de este nodo.

Véase también setOpacity().

void QSGOpacityNode::setOpacity(qreal opacity)

Establece la opacidad de este nodo a opacity.

Antes de renderizar el gráfico, el renderizador hará una pasada de actualización sobre el subárbol para propagar la opacidad a sus hijos.

El valor estará comprendido entre 0 y 1.

Véase también 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.