Sur cette page

HueSaturation QML Type

Modifie les couleurs de l'élément source dans l'espace colorimétrique HSL. Plus d'informations...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propriétés

Description détaillée

L'effet HueSaturation est similaire à l'effet Colorize, mais les valeurs des propriétés de teinte et de saturation sont gérées différemment. L'effet HueSaturation décale toujours la teinte, la saturation et la luminosité par rapport à l'original, au lieu de les fixer.

SourceEffet appliqué

Exemple d'application

L'exemple suivant montre comment appliquer l'effet.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    HueSaturation {
        anchors.fill: bug
        source: bug
        hue: -0.3
        saturation: 0.5
        lightness: -0.1
    }
}

Propriété Documentation

cached : bool

Cette propriété permet de mettre en cache les pixels de sortie de l'effet afin d'améliorer les performances de rendu.

Chaque fois que les propriétés de la source ou de l'effet sont modifiées, les pixels du cache doivent être mis à jour. La consommation de mémoire augmente, car une mémoire tampon supplémentaire est nécessaire pour stocker la sortie de l'effet.

Il est recommandé de désactiver le cache lorsque les propriétés de la source ou de l'effet sont animées.

Par défaut, la propriété est définie sur false.

hue : real

Cette propriété définit la valeur de teinte qui est ajoutée à la valeur de teinte de la source.

La valeur est comprise entre -1,0 (diminution) et 1,0 (augmentation). Par défaut, la propriété est définie sur 0.0 (pas de changement).

Exemples de résultats avec différentes valeurs de teinte

teinte : -0,3 teinte : 0.0 teinte : 0.3
saturation: 0saturation: 0saturation: 0
lightness: 0lightness: 0lightness: 0

lightness : real

Cette propriété définit la valeur de clarté qui est ajoutée à la valeur de saturation de la source.

La valeur est comprise entre -1,0 (diminution) et 1,0 (augmentation). Par défaut, la propriété est définie sur 0.0 (pas de changement).

Exemples de résultats avec différentes valeurs de luminosité

luminosité : -0,5 luminosité : 0.0 luminosité : 0.5
hue: 0hue: 0hue: 0
saturation: 0saturation: 0saturation: 0

saturation : real

Cette propriété définit la valeur de saturation qui est ajoutée à la valeur de saturation de la source.

La valeur est comprise entre -1,0 (diminution) et 1,0 (augmentation). Par défaut, la propriété est définie sur 0.0 (pas de changement).

Exemples de sorties avec différentes valeurs de saturation

saturation : -0.8 saturation : 0.0 saturation : 1.0
hue: 0hue: 0hue: 0
lightness: 0lightness: 0lightness: 0

source : variant

Cette propriété définit l'élément source qui fournit les pixels sources de l'effet.

Remarque : il n'est pas possible de laisser l'effet s'inclure lui-même, par exemple en définissant la source sur le parent de l'effet.

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