En esta página

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

Para 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

Blend

Combina dos elementos de origen utilizando un modo de fusión

Color

BrightnessContrast

Ajusta el brillo y el contraste

ColorOverlay

Modifica los colores del elemento de origen aplicando un color de superposición

Colorize

Establece el color en el espacio de color HSL

Desaturate

Reduce la saturación de los colores

GammaAdjust

Modifica la luminancia del elemento de origen

HueSaturation

Modifica los colores del elemento de origen en el espacio de color HSL

LevelAdjust

Ajusta los niveles de color en el espacio de color RGBA

Degradado

ConicalGradient

Dibuja un degradado cónico

LinearGradient

Dibuja un degradado lineal

RadialGradient

Dibuja un degradado radial

Distorsión

Displace

Mueve los píxeles del elemento de origen según el mapa de desplazamiento indicado

Sombra proyectada

DropShadow

Genera una sombra suave detrás del elemento de origen

InnerShadow

Genera una sombra coloreada y difuminada en el interior del elemento de origen

Desenfoque

FastBlur

Aplica un efecto de desenfoque rápido a uno o más elementos de origen

GaussianBlur

Aplica un efecto de desenfoque de mayor calidad

MaskedBlur

Aplica un efecto de desenfoque con intensidad variable

RecursiveBlur

Desenfoca repetidamente, proporcionando un efecto de desenfoque intenso

Desenfoque de movimiento

DirectionalBlur

Aplica un efecto de desenfoque en la dirección especificada

RadialBlur

Aplica un desenfoque direccional en una dirección circular alrededor del punto central de los elementos

ZoomBlur

Aplica un efecto de desenfoque direccional hacia el punto central del elemento de origen

Resplandor

Glow

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

RectangularGlow

Genera un rectángulo desenfocado y coloreado, lo que da la impresión de que la imagen de origen está brillando

Máscara

OpacityMask

Enmascara el elemento de origen con otro elemento

ThresholdMask

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.