Colorize QML Type

Définit la couleur 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 est similaire à celui obtenu lorsqu'un verre coloré est superposé à une image en niveaux de gris. Colorize utilise l'espace colorimétrique teinte, saturation et luminosité (HSL). Vous pouvez spécifier une valeur souhaitée pour chaque propriété. L'effet « HueSaturation » vous permet de modifier toutes les valeurs HSL.

Vous pouvez également utiliser l’effet « ColorOverlay » pour coloriser l’élément source dans l’espace colorimétrique RGBA.

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
    }

    Colorize {
        anchors.fill: bug
        source: bug
        hue: 0.0
        saturation: 0.5
        lightness: -0.2
    }
}

Documentation des 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 de 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 utilisée pour colorer la source.

La valeur est comprise entre 0,0 et 1,0. Par défaut, la propriété est définie sur 0.0, ce qui produit une couleur légèrement rouge.

lightness : real

Cette propriété définit dans quelle mesure la valeur de luminosité de la source est augmentée ou diminuée.

Contrairement aux propriétés de teinte et de saturation, la luminosité ne définit pas la valeur utilisée, mais modifie la valeur de luminosité existante du pixel 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 utilisée pour colorer la source.

La valeur varie de 0,0 (désaturé) à 1,0 (saturé). Par défaut, la propriété est définie sur 1.0 (saturé).

source : variant

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