BrightnessContrast QML Type
Règle la luminosité et le contraste. Plus d'informations...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propriétés
- brightness : real
- cached : bool
- contrast : real
- source : variant
Description détaillée
Note : Le composant MultiEffect fournit un effet de luminosité et de contraste avec quelques avantages en termes de performances. Pour les nouveaux codes, il devrait être considéré comme une alternative à l'utilisation de Qt Graphical Effects.
Cet effet ajuste les couleurs de l'élément source. L'ajustement de la luminosité modifie la luminance perçue de l'élément source. L'ajustement du contraste augmente ou diminue les variations de couleur et de luminosité.
| 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 } BrightnessContrast { anchors.fill: bug source: bug brightness: 0.5 contrast: 0.5 } }
Propriété Documentation
brightness : real
Cette propriété définit dans quelle mesure la luminosité de la source est augmentée ou diminuée.
La valeur est comprise entre -1,0 et 1,0. Par défaut, la propriété est définie sur 0.0 (aucun changement).
| Exemples de sortie avec différentes valeurs de luminosité | ||
|---|---|---|
|
|
|
| luminosité : -0,25 | luminosité : 0 | luminosité : 0.5 |
| contrast: 0 | contrast: 0 | contrast: 0 |
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.
contrast : real
Cette propriété définit dans quelle mesure le contraste de la source est augmenté ou diminué. La diminution du contraste est linéaire, mais l'augmentation est appliquée à l'aide d'une courbe non linéaire afin de permettre un ajustement du contraste très élevé à l'extrémité supérieure de la plage de valeurs.
| Courbe de réglage du contraste |
|---|
|
La valeur est comprise entre -1,0 et 1,0. Par défaut, la propriété est définie sur 0.0 (pas de changement).
| Exemples de sortie avec différentes valeurs de contraste | ||
|---|---|---|
|
|
|
| contraste : -0,5 | contraste : 0 | contraste : 0.5 |
| brightness: 0 | brightness: 0 | brightness: 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.








