Colorize QML Type

Définit la couleur dans l'espace colorimétrique HSL. Plus d'informations...

• 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 à ce qui se produit lorsqu'un verre colorisé est placé au-dessus d'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é. Vous pouvez modifier toutes les valeurs HSL avec l'effet HueSaturation.

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

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 la teinte utilisée pour coloriser 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 décale la valeur de luminosité du pixel source existant.

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

saturation : real

Cette propriété définit la valeur de saturation utilisée pour coloriser la source.

La valeur est comprise entre 0,0 (désaturé) et 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 sources de l'effet.