LinearGradient QML Type

Dessine un dégradé linéaire. Plus d'informations...

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

Propriétés

• cached : bool
• end : variant
• gradient : Gradient
• source : variant
• start : variant

Description détaillée

Un dégradé est défini par deux couleurs ou plus, qui sont mélangées de manière transparente. Les couleurs partent du point de départ donné et se terminent au point d'arrivée donné.

Exemple d'application

L'exemple suivant montre comment appliquer l'effet.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    LinearGradient {
        anchors.fill: parent
        start: Qt.point(0, 0)
        end: Qt.point(0, 300)
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 1.0; color: "black" }
        }
    }
}

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.

end : variant

Cette propriété définit le point final où la couleur à une position de gradient de 1,0 est rendue. Les couleurs à des valeurs de position plus petites sont rendues linéairement vers le point de départ. Le point est donné en pixels et la valeur par défaut est Qt.point(0, height). En définissant les valeurs par défaut pour start et la fin, on obtient un dégradé linéaire sur toute la hauteur de l'axe des ordonnées.

gradient : Gradient

Un dégradé est défini par deux couleurs ou plus, qui sont mélangées de manière transparente. Les couleurs sont spécifiées sous la forme d'un ensemble d'éléments enfants GradientStop, chacun d'eux définissant une position sur le dégradé entre 0,0 et 1,0 et une couleur. La position de chaque GradientStop est définie par la propriété position et la couleur est définie par la propriété color.

Gradient {
  GradientStop {
     position: 0.000
     color: Qt.rgba(1, 0, 0, 1)
  }
  GradientStop {
     position: 0.167
     color: Qt.rgba(1, 1, 0, 1)
  }
  GradientStop {
     position: 0.333
     color: Qt.rgba(0, 1, 0, 1)
  }
  GradientStop {
     position: 0.500
     color: Qt.rgba(0, 1, 1, 1)
  }
  GradientStop {
     position: 0.667
     color: Qt.rgba(0, 0, 1, 1)
  }
  GradientStop {
     position: 0.833
     color: Qt.rgba(1, 0, 1, 1)
  }
  GradientStop {
     position: 1.000
     color: Qt.rgba(1, 0, 0, 1)
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#F0F0F0"
  }
  GradientStop {
    position: 0.5
    color: "#000000"
  }
  GradientStop {
    position: 1.0
    color: "#F0F0F0"
  }
}

Gradient {
  GradientStop {
    position: 0.0
    color: "#00000000"
  }
  GradientStop {
    position: 1.0
    color: "#FF000000"
  }
}

source : variant

Cette propriété définit l'élément qui va être rempli avec un dégradé. L'élément source est rendu dans un tampon de pixels intermédiaire et les valeurs alpha du résultat sont utilisées pour déterminer la visibilité des pixels du dégradé dans l'affichage. La valeur par défaut de la source est indéfinie et, dans ce cas, toute la zone d'effet est remplie de dégradé.

start : variant

Cette propriété définit le point de départ du rendu de la couleur à une position de gradient de 0,0. Les couleurs à des valeurs de position plus élevées sont rendues de manière linéaire vers le point final. Le point est donné en pixels et la valeur par défaut est Qt.point(0, 0). En définissant les valeurs par défaut pour le début et end, on obtient un dégradé linéaire sur toute la hauteur de l'axe des ordonnées.