Qt 5 Compatibility APIs: Graphical Effects

Le module Qt « Graphical Effects » est fourni pour assurer la 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 pouvant être ajoutés à l’interface utilisateur d Qt Quick en tant que composants d’interface.

Remarque : le module Qt Graphical Effects présentant des contraintes de performances lorsque les effets sont superposés, il est principalement inclus pour assurer la compatibilité avec les applications Qt 5. Nous recommandons d’écrire le nouveau code en utilisant l’une des nouvelles solutions pour les effets introduites dans Qt 6. Pour les effets d’interface utilisateur classiques, Qt Quick propose l’ MultiEffect, qui applique plusieurs effets en un seul passage. Pour les cas d’utilisation avancés qui ne sont pas couverts par ce composant, l’ Qt Quick Effect Maker outil peut être utilisé pour personnaliser et affiner précisément les effets de shader dont vous avez besoin.

Utilisation de Qt Graphical Effects

Pour importer les types d’ Graphical Effects Qt, 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 de l’effet. Les effets disposent d’une ou plusieurs propriétés « source » permettant de spécifier l’entrée visuelle à laquelle l’effet s’applique. La sortie visuelle modifiée est ensuite présentée dans l’élément d’effet lui-même. Le type de l’élément source peut être n’importe quel type QML, y compris une vidéo ou un autre effet. Enchaîner plusieurs effets est un moyen simple de créer un résultat encore plus impressionnant.

Graphical EffectsLa liste suivante présente la répartition fonctionnelle des types faisant partie de Qt XML-ph-0000@deepl.internal .

Remarque : les effets ne sont pas disponibles lors de l’exécution avec le backend « software » de Qt Quick. Pour plus d’informations sur les backends de graphe de scène d’ Qt Quick, consultez la section « Adaptations du graphe de scène ».

Remarque : les effetsgénérés à l’exécution , tels que GaussianBlur, stockent les fichiers de shaders dans un espace de stockage temporaire à l’aide de QTemporaryFile; ils nécessitent donc un système de fichiers accessible en écriture.

Blend

Fusionne deux éléments sources à l’aide d’un mode de fusion

Couleur

BrightnessContrast	Règle la luminosité et le contraste
ColorOverlay	Modifie les couleurs de l'élément source en appliquant une couleur de superposition
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

Déformation

Displace

Déplace les pixels de l'élément source selon la carte de déplacement fournie

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 meilleure qualité
MaskedBlur	Applique un effet de flou d’intensité variable
RecursiveBlur	Applique plusieurs flous successifs, pour un effet de flou prononcé

Flou de mouvement

DirectionalBlur	Applique un effet de flou dans la direction spécifiée
RadialBlur	Applique un flou directionnel selon un mouvement circulaire autour du point central des éléments
ZoomBlur	Applique un effet de flou directionnel vers le centre de l'élément source

Lueur

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 coloré, ce qui donne l’impression que l’élément source rayonne

Masque

OpacityMask	Masque l'élément source à l'aide d'un autre élément
ThresholdMask	Masque l'élément source à l'aide d'un autre élément et applique une valeur de 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.