GammaAdjust QML Type
Modifie la luminance de l'élément source. Plus d'informations...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propriétés
Description détaillée
GammaAdjust est appliqué à chaque pixel selon la courbe prédéfinie comme une expression de loi de puissance, où la propriété gamma est utilisée comme exposant d'échelle réciproque. Pour plus de détails, se référer à la documentation de la propriété gamma.
| Source | Effet appliqué |
|---|---|
|
|
Exemple d'application
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 } GammaAdjust { anchors.fill: bug source: bug gamma: 0.45 } }
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 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.
gamma : real
Cette propriété définit le facteur de changement de la luminance de chaque pixel selon l'équation :
luminance = pow(original_luminance, 1.0 / gamma); // The luminance is assumed to be between 0.0 and 1.0
Les valeurs gamma inférieures à 1,0 assombrissent l'image, les valeurs supérieures à 1,0 l'éclaircissent.
La valeur va de 0,0 (le plus sombre) à inf (le plus clair). Par défaut, la propriété est définie sur 1.0 (aucun changement).
| Exemples de sorties avec différentes valeurs de gamma | ||
|---|---|---|
|
|
|
| gamma : 0,5 | gamma : 1.0 | gamma : 2.0 |
| Courbes de luminance des pixels des images ci-dessus. | ||
|---|---|---|
|
|
|
| Courbe rouge : gamma par défaut (1.0) | ||
| Courbe jaune : effet appliqué | ||
| Axe X : luminance originale des pixels | ||
| Axe Y : luminance du pixel avec l'effet appliqué |
source : variant
Cette propriété définit l'élément source pour lequel la luminance va être ajustée.
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.







