Colorize QML Type
Définit la couleur dans l'espace colorimétrique HSL. Plus d'informations...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
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.
| Source | Effet appliqué |
|---|---|
|
|
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 teinte utilisée pour coloriser la source.
La valeur est comprise entre 0,0 et 1,0. Par défaut, la propriété est fixée à 0.0, ce qui produit une couleur légèrement rouge.
| Valeurs de teinte autorisées |
|---|
|
| Exemples de sortie avec différentes valeurs de teinte | ||
|---|---|---|
|
|
|
| teinte : 0,2 | teinte : 0,5 | teinte : 0.8 |
| saturation: 1 | saturation: 1 | saturation: 1 |
| lightness: 0 | lightness: 0 | lightness: 0 |
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).
| Exemples de résultats avec différentes valeurs de luminosité | ||
|---|---|---|
|
|
|
| luminosité : -0,75 | luminosité : 0 | luminosité : 0.75 |
| hue: 0 | hue: 0 | hue: 0 |
| saturation: 1 | saturation: 1 | saturation: 1 |
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.
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.
© 2025 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.











