Sur cette page

GammaAdjust QML Type

Modifie la luminance de l'élément source. En savoir plus...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propriétés

Description détaillée

GammaAdjust est appliqué à chaque pixel selon une courbe prédéfinie sous la forme d'une loi de puissance, où la propriété gamma sert d'exposant de mise à l'échelle réciproque. Pour plus de détails, consultez la documentation relative aux propriétés sur gamma.

SourceEffet appliqué

Coléoptère noir sur une feuille

Beetle avec réglage gamma 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
    }

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

gamma : real

Cette propriété définit le facteur de modification qui détermine la manière dont la luminance de chaque pixel est modifiée selon l'équation suivante :

luminance = pow(original_luminance, 1.0 / gamma); // The luminance is assumed to be between 0.0 and 1.0

Régler les valeurs de gamma en dessous de 1,0 assombrit l'image, tandis que les valeurs supérieures à 1,0 l'éclaircissent.

La valeur varie de 0,0 (la plus sombre) à inf (la plus claire). Par défaut, la propriété est définie sur 1.0 (aucune modification).

Exemples de résultats avec différentes valeurs de gamma

Coléoptère noirci, gamma 0,5

Beetle en version gamma standard

Coléoptère éclairé, gamma 2.0

gamma : 0,5 gamma : 1,0 gamma : 2,0
Courbes de luminance des pixels des images ci-dessus.

Courbe de luminance pour un gamma de 0,5

Courbe de luminance pour un gamma de 1,0

Courbe de luminance pour un gamma de 2,0

Courbe rouge : gamma par défaut (1,0)
Courbe jaune : effet appliqué
Axe X : luminance d'origine des pixels
Axe Y : luminance des pixels avec l'effet appliqué

source : variant

Cette propriété définit l'élément source dont la luminance va être ajustée.

Remarque : il n’est pas possible de faire en sorte que l’effet s’applique à lui-même, par exemple en définissant la source comme étant 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.