Qt 5 Compatibility APIs: Graphical Effects
El módulo Qt Graphical Effects se proporciona para compatibilidad con aplicaciones escritas para Qt 5.
El módulo Qt Graphical Effects proporciona un conjunto de tipos QML para añadir efectos visualmente impresionantes y configurables a las interfaces de usuario. Los efectos son elementos visuales que pueden añadirse a la interfaz de usuario Qt Quick como componentes UI.
Nota: Dado que el módulo Qt Graphical Effects tiene limitaciones de rendimiento cuando se apilan efectos, se incluye principalmente por compatibilidad con aplicaciones Qt 5. Recomendamos que el nuevo código se escriba con una de las nuevas soluciones para efectos que se introdujeron en Qt 6. Para efectos típicos de interfaz de usuario, Qt Quick dispone de MultiEffect, que aplica múltiples efectos en una sola pasada. Para casos de uso avanzados que no están cubiertos por este componente, se puede utilizar la herramienta Qt Quick Effect Maker para personalizar y ajustar exactamente los efectos de sombreado que necesites.
Uso de Qt Graphical Effects
Para importar los tipos de Qt Graphical Effects, incluya el módulo Qt Graphical Effects añadiendo la siguiente declaración al archivo QML:
import Qt5Compat.GraphicalEffects
Para utilizar los efectos, basta con añadir una declaración de efecto específica a la escena QML y configurar las propiedades de los efectos. Los efectos tienen una o más propiedades de origen para especificar la entrada visual a la que se aplica el efecto. La salida visual alterada se presenta en el propio elemento del efecto. El tipo de elemento fuente puede ser cualquier tipo QML, incluso vídeo u otro efecto. La combinación de varios efectos es una forma sencilla de crear resultados aún más impresionantes.
La siguiente lista presenta la división funcional de los tipos que forman parte de Qt Graphical Effects.
Nota: Los efectos no están disponibles cuando se ejecutan con el backend software de Qt Quick. Para obtener más información sobre los backends de gráficos de escena de Qt Quick, consulte Adaptaciones de gráficos de escena.
Nota: Los efectos generados en tiempo de ejecución como GaussianBlur almacenarán los archivos shader en un almacenamiento temporal utilizando QTemporaryFile, por lo que requieren un sistema de archivos con permisos de escritura.
Fusionar
Fusiona dos elementos fuente utilizando un modo de mezcla |
Color
Ajusta el brillo y el contraste | |
Altera los colores del elemento fuente aplicando un color de superposición | |
Establece el color en el espacio de color HSL | |
Reduce la saturación de los colores | |
Altera la luminancia del elemento fuente | |
Altera los colores del elemento fuente en el espacio de color HSL | |
Ajusta los niveles de color en el espacio de color RGBA |
Degradado
Dibuja un degradado cónico | |
Dibuja un degradado lineal | |
Dibuja un degradado radial |
Distorsión
Mueve los píxeles del elemento de origen según el mapa de desplazamiento dado |
Sombra
Genera una sombra suave detrás del elemento fuente | |
Genera una sombra coloreada y difuminada dentro del elemento fuente |
Desenfoque
Aplica un efecto de desenfoque rápido a uno o más elementos fuente | |
Aplica un efecto de desenfoque de mayor calidad | |
Aplica un efecto de desenfoque con una intensidad variable | |
Desenfoca repetidamente, proporcionando un fuerte efecto de desenfoque |
Desenfoque de movimiento
Aplica un efecto de desenfoque en la dirección especificada | |
Aplica un efecto de desenfoque direccional en una dirección circular alrededor del punto central del elemento | |
Aplica un efecto de desenfoque direccional hacia el punto central del elemento de origen |
Resplandor
Genera una imagen borrosa y coloreada de la fuente y la coloca detrás de la original, dando la impresión de que la fuente está brillando | |
Genera un rectángulo difuminado y coloreado que da la impresión de que la fuente brilla. |
Máscara
Enmascara el elemento fuente con otro elemento | |
Enmascara el elemento fuente con otro elemento y aplica un valor umbral |
© 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.
