LevelAdjust QML Type

Permet de régler les niveaux de couleur dans l'espace colorimétrique RGBA. En savoir plus...

• 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 de régler les couleurs de l'élément source séparément pour chaque canal de couleur. Il est possible de régler le contraste de l'élément source et de modifier la balance des couleurs.

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

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

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

Régler les valeurs de gamma à QtVector3d(1,0, 1,0, 1,0) assombrit l'image, tandis que des valeurs supérieures à QtVector3d(1,0, 1,0, 1,0) l'éclaircissent.

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

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 dont la valeur est supérieure à celle de cette propriété sont affichés en blanc (pour chaque canal de couleur). La diminution de cette valeur éclaircit les zones claires.

La valeur est comprise entre « #ffffffff » et « #00000000 ». Par défaut, la propriété est définie sur "#ffffffff" (aucune modification).

maximumOutput : color

Cette propriété définit le niveau de sortie maximal pour chaque canal de couleur. La diminution de cette valeur assombrit les zones claires, ce qui réduit le contraste.

La valeur varie de « #ffffffff » à « #00000000 ». Par défaut, la propriété est définie sur "#ffffffff" (aucun changement).

minimumInput : color

Cette propriété définit le niveau d'entrée minimal pour chaque canal de couleur. Elle détermine le point noir : tous les pixels dont la valeur est inférieure à celle de cette propriété sont affichés en noir (pour chaque canal de couleur). Augmenter cette valeur assombrit les zones sombres.

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

minimumOutput : color

Cette propriété définit le niveau de sortie minimal pour chaque canal de couleur. Augmenter cette valeur éclaircit les zones sombres, ce qui réduit 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 source à l'effet.