Qt 5 Compatibility APIs: Graphical Effects

Le module Qt Graphical Effects est fourni à des fins de compatibilité avec les applications écrites pour Qt 5.

Le module Qt Graphical Effects fournit un ensemble de types QML permettant d'ajouter des effets visuellement impressionnants et configurables aux interfaces utilisateur. Les effets sont des éléments visuels qui peuvent être ajoutés à l'interface utilisateur Qt Quick en tant que composants d'interface utilisateur.

Remarque : étant donné que le module Qt Graphical Effects présente des contraintes de performance lorsque les effets sont empilés, il est principalement inclus à des fins de compatibilité avec les applications Qt 5. Nous recommandons que le nouveau code soit écrit avec l'une des nouvelles solutions pour les effets qui ont été introduites dans Qt 6. Pour les effets d'interface utilisateur typiques, Qt Quick dispose de MultiEffect, qui applique plusieurs effets en une seule passe. Pour les cas d'utilisation avancés qui ne sont pas couverts par ce composant, l'outil Qt Quick Effect Maker peut être utilisé pour personnaliser et affiner exactement les effets de shaders dont vous avez besoin.

Utilisation de Qt Graphical Effects

Pour importer les types Qt Graphical Effects, incluez le module Qt Graphical Effects en ajoutant l'instruction suivante au fichier QML :

import Qt5Compat.GraphicalEffects

Pour utiliser les effets, il suffit d'ajouter une déclaration d'effet spécifique à la scène QML et de configurer les propriétés des effets. Les effets ont une ou plusieurs propriétés de source pour spécifier l'entrée visuelle à laquelle l'effet est appliqué. La sortie visuelle modifiée est ensuite présentée dans l'élément d'effet lui-même. Le type d'élément source peut être n'importe quel type QML, même une vidéo ou un autre effet. L'enchaînement de plusieurs effets est un moyen simple de créer des résultats encore plus impressionnants.

La liste suivante présente la division fonctionnelle des types qui font partie de Qt Graphical Effects.

Remarque : les effets ne sont pas disponibles lorsque l'on utilise le backend software de Qt Quick. Pour plus d'informations sur les backends de graphes de scène Qt Quick, voir Adaptations de graphes de scène.

Remarque : les effets générés par le moteur d'exécution, tels que GaussianBlur, stockent les fichiers de shaders dans un espace de stockage temporaire à l'aide de QTemporaryFile, ce qui nécessite un système de fichiers accessible en écriture.

Mélange

Blend

Fusionne deux éléments sources en utilisant un mode de fusion

Couleur

BrightnessContrast	Ajuste la luminosité et le contraste
ColorOverlay	Modifie les couleurs de l'élément source en appliquant une couleur de recouvrement
Colorize	Définit la couleur dans l'espace colorimétrique HSL
Desaturate	Réduit la saturation des couleurs
GammaAdjust	Modifie la luminance de l'élément source
HueSaturation	Modifie les couleurs de l'élément source dans l'espace colorimétrique HSL
LevelAdjust	Ajuste les niveaux de couleur dans l'espace colorimétrique RGBA

Dégradé

ConicalGradient	Dessine un dégradé conique
LinearGradient	Dessine un dégradé linéaire
RadialGradient	Dessine un dégradé radial

Distorsion

Displace

Déplace les pixels de l'élément source en fonction de la carte de déplacement donnée.

Ombre portée

DropShadow	Génère une ombre douce derrière l'élément source
InnerShadow	Génère une ombre colorée et floue à l'intérieur de l'élément source

Flou

FastBlur	Applique un effet de flou rapide à un ou plusieurs éléments source
GaussianBlur	Applique un effet de flou de qualité supérieure
MaskedBlur	Applique un effet de flou avec une intensité variable
RecursiveBlur	Flou répété, produisant un effet de flou important.

Flou de mouvement

DirectionalBlur	Applique un effet de flou à la direction spécifiée
RadialBlur	Applique un effet de flou directionnel dans une direction circulaire autour du point central de l'élément
ZoomBlur	Applique un effet de flou directionnel vers le point central de l'élément source

Éclat

Glow	Génère une image floue et colorisée de la source et la place derrière l'original, donnant l'impression que la source brille.
RectangularGlow	Génère un rectangle flou et colorisé qui donne l'impression que la source est lumineuse.

Masque

OpacityMask	Masque l'élément source avec un autre élément
ThresholdMask	Masque l'élément source avec un autre élément et applique une valeur seuil.

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