LevelAdjust QML Type

Ajuste les niveaux de couleur dans l'espace colorimétrique RGBA. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• cached : bool
• gamma : variant
• maximumInput : color
• maximumOutput : color
• minimumInput : color
• minimumOutput : color
• source : variant

Description détaillée

Cet effet permet d'ajuster les couleurs de l'élément source séparément pour chaque canal de couleur. Le contraste de l'élément source peut être ajusté et la balance des couleurs modifiée.

Exemple

L'exemple suivant montre comment appliquer l'effet.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: butterfly
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    LevelAdjust {
        anchors.fill: butterfly
        source: butterfly
        minimumOutput: "#00ffffff"
        maximumOutput: "#ff000000"
    }
}

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 : variant

Cette propriété définit le facteur de changement de la valeur du canal de couleur de chaque pixel en fonction de l'équation :

result.rgb = pow(original.rgb, 1.0 / gamma.rgb);

Les valeurs gamma inférieures à QtVector3d(1.0, 1.0, 1.0) assombrissent l'image, les valeurs supérieures à QtVector3d(1.0, 1.0, 1.0) l'éclaircissent.

La valeur va de QtVector3d(0.0, 0.0, 0.0) (la plus sombre) à inf (la plus claire). Par défaut, la propriété est définie sur QtVector3d(1.0, 1.0, 1.0) (aucun changement).

maximumInput : color

Cette propriété définit le niveau d'entrée maximal pour chaque canal de couleur. Elle définit le point blanc, tous les pixels ayant une valeur supérieure à cette propriété sont rendus blancs (par canal de couleur). La diminution de la valeur éclaircit les zones claires.

La valeur est comprise entre "#ffffffff" et "#00000000". Par défaut, la propriété est définie sur "#ffffffff" (aucun changement).

maximumOutput : color

Cette propriété définit le niveau de sortie maximum pour chaque canal de couleur. En diminuant la valeur, on assombrit les zones claires, ce qui réduit le contraste.

La valeur est comprise entre "#ffffffff" et "#00000000". Par défaut, la propriété est définie sur "#ffffffff" (pas de changement).

minimumInput : color

Cette propriété définit le niveau d'entrée minimum pour chaque canal de couleur. Elle définit le point noir, tous les pixels ayant une valeur inférieure à cette propriété sont rendus noirs (par canal de couleur). L'augmentation de la valeur assombrit les zones sombres.

La valeur est comprise entre "#00000000" et "#ffffffff". Par défaut, la propriété est définie sur "#00000000" (pas de changement).

minimumOutput : color

Cette propriété définit le niveau de sortie minimum pour chaque canal de couleur. L'augmentation de la valeur éclaircit les zones sombres, réduisant ainsi le contraste.

La valeur est comprise entre "#00000000" et "#ffffffff". Par défaut, la propriété est définie sur "#00000000" (aucun changement).

source : variant

Cette propriété définit l'élément source qui fournit les pixels sources de l'effet.