Sur cette page

BrightnessContrast QML Type

Permet de régler la luminosité et le contraste. En savoir plus...

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

Item

Propriétés

Description détaillée

Remarque : le composant ` MultiEffect ` offre un effet de luminosité et de contraste présentant certains avantages en termes de performances. Pour le nouveau code, il convient de l'envisager comme une alternative à l'utilisation de `Qt Graphical Effects`.

Cet effet ajuste les couleurs de l'élément source. Le réglage de la luminosité modifie la luminance perçue de l'élément source. Le réglage du contraste augmente ou diminue les variations de couleur et de luminosité.

SourceEffet appliqué

Coléoptère noir sur une feuille

Beetle avec luminosité et contraste réglés

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
    }
}

Documentation sur les propriétés

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 résultats avec différentes valeurs de luminosité

Coléoptère sombre, luminosité -0,25

Coléoptère à luminosité normale

Coléoptère éclairci, luminosité 0,5

luminosité : -0,25 luminosité : 0 luminosité : 0,5
contrast: 0contrast: 0contrast: 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 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 ».

contrast : real

Cette propriété définit dans quelle mesure le contraste de la source est augmenté ou réduit. La réduction du contraste est linéaire, mais l’augmentation s’applique selon une courbe non linéaire afin de permettre un réglage très élevé du contraste dans la partie supérieure de la plage de valeurs.

Courbe de réglage du contraste

Graphique illustrant la 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 » (aucun changement).

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

Coccinelle à contraste réduit

Coléoptère avec un contraste normal

Coccinelle au contraste accru

contrast : -0,5 contraste : 0 contraste : 0,5
brightness: 0brightness: 0brightness: 0

source : variant

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

Remarque : il n'est pas possible de faire en sorte que l'effet s'inclue 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.