Qt 5 Compatibility APIs: Graphical Effects
El módulo Qt « Graphical Effects » se proporciona para garantizar la compatibilidad con las aplicaciones escritas para Qt 5.
El módulo Qt « Graphical Effects » proporciona un conjunto de tipos QML para añadir efectos visualmente impactantes y configurables a las interfaces de usuario. Los efectos son elementos visuales que se pueden añadir a una interfaz de usuario de « Qt Quick » como componentes de la interfaz de usuario.
Nota: Dado que el módulo Qt Graphical Effects presenta limitaciones de rendimiento cuando se apilan efectos, se incluye principalmente para garantizar la compatibilidad con las aplicaciones de Qt 5. Recomendamos escribir el código nuevo utilizando una de las nuevas soluciones para efectos introducidas en Qt 6. Para los efectos típicos de la interfaz de usuario, Qt Quick ofrece el MultiEffect, que aplica múltiples efectos en una sola pasada. Para casos de uso avanzados que no cubra este componente, se puede utilizar la herramienta Effect Maker deQt Quick para personalizar y ajustar con precisión los efectos de sombreado que necesites.
Uso de Qt Graphical Effects
Para importar los tipos de « Graphical Effects » de Qt, incluya el módulo Qt Graphical Effects añadiendo la siguiente instrucción al archivo QML:
import Qt5Compat.GraphicalEffectsPara utilizar los efectos, basta con añadir una declaración de efecto específica a la escena QML y configurar las propiedades del efecto. 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 modificada se presenta entonces en el propio elemento de efecto. El tipo de elemento de origen puede ser cualquier tipo QML, incluso vídeo u otro efecto. Encadenar varios efectos es una forma sencilla de crear resultados aún más impresionantes.
Graphical EffectsLa siguiente lista presenta la clasificación funcional de los tipos que forman parte de Qt XML-ph-0000@deepl.internal .
Nota: Los efectos no están disponibles cuando se ejecuta con el backend « software » de Qt Quick. Para obtener más información sobre los backends de grafos de escena de Qt Quick, consulta Adaptaciones de grafos de escena.
Nota: Los efectosgenerados en tiempo de ejecución , como GaussianBlur, almacenarán los archivos de shader en un espacio de almacenamiento temporal utilizando QTemporaryFile, por lo que requieren un sistema de archivos en el que se pueda escribir.
Fusionar
Combina dos elementos de origen utilizando un modo de fusión |
Color
Ajusta el brillo y el contraste | |
Modifica los colores del elemento de origen aplicando un color de superposición | |
Establece el color en el espacio de color HSL | |
Reduce la saturación de los colores | |
Modifica la luminancia del elemento de origen | |
Modifica los colores del elemento de origen 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 indicado |
Sombra proyectada
Genera una sombra suave detrás del elemento de origen | |
Genera una sombra coloreada y difuminada en el interior del elemento de origen |
Desenfoque
Aplica un efecto de desenfoque rápido a uno o más elementos de origen | |
Aplica un efecto de desenfoque de mayor calidad | |
Aplica un efecto de desenfoque con intensidad variable | |
Desenfoca repetidamente, proporcionando un efecto de desenfoque intenso |
Desenfoque de movimiento
Aplica un efecto de desenfoque en la dirección especificada | |
Aplica un desenfoque direccional en una dirección circular alrededor del punto central de los elementos | |
Aplica un efecto de desenfoque direccional hacia el punto central del elemento de origen |
Resplandor
Genera una imagen desenfocada y coloreada del elemento de origen y la coloca detrás del original, dando la impresión de que este último brilla | |
Genera un rectángulo desenfocado y coloreado, lo que da la impresión de que la imagen de origen está brillando |
Máscara
Enmascara el elemento de origen con otro elemento | |
Enmascara el elemento de origen 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.