HueSaturation QML Type

Modifie les couleurs des éléments source dans l'espace colorimétrique HSL. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• cached : bool
• hue : real
• lightness : real
• saturation : real
• source : variant

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 » modifie toujours la teinte, la saturation et la luminosité de l'image d'origine, au lieu de les définir.

Exemple

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
    }
}

Documentation sur les propriétés

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 un tampon mémoire 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 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 » (aucun changement).

lightness : real

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

La valeur varie de -1,0 (diminution) à 1,0 (augmentation). Par défaut, la propriété est définie sur « 0.0 » (aucun changement).

saturation : real

Cette propriété définit la valeur de saturation qui est ajoutée à la valeur de saturation 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 » (aucun changement).

source : variant

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