ConicalGradient QML Type

Dessine un dégradé conique. En savoir plus…

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

Propriétés

• angle : real
• cached : bool
• gradient : Gradient
• horizontalOffset : real
• source : variant
• verticalOffset : real

Description détaillée

Un dégradé est défini par deux couleurs ou plus, qui se fondent harmonieusement les unes dans les autres. Les couleurs commencent à l'angle spécifié et se terminent à une valeur d'angle supérieure de 360 degrés.

Exemple

L'exemple suivant montre comment appliquer l'effet.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    ConicalGradient {
        anchors.fill: parent
        angle: 0.0
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 1.0; color: "black" }
        }
    }
}

Documentation des propriétés

angle : real

Cette propriété définit l'angle de départ à partir duquel la couleur correspondant à la position 0,0 du dégradé est affichée. Les couleurs correspondant à des positions plus élevées sont affichées selon des angles plus grands et se fondent de manière homogène. Les valeurs d'angle augmentent dans le sens des aiguilles d'une montre.

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

gradient : Gradient

Un dégradé est défini par deux couleurs ou plus, qui s'estompent de manière homogène. Les couleurs sont spécifiées sous la forme d'un ensemble d'éléments enfants de type « GradientStop », dont chacun définit une position sur le dégradé (comprise entre 0,0 et 1,0) et une couleur. La position de chaque élément « GradientStop » est définie par la propriété « position ». 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"
  }
}

horizontalOffset : real

Les propriétés `horizontalOffset` et ` verticalOffset ` définissent le décalage, en pixels, du point central du dégradé par rapport au centre de l'élément.

La valeur est comprise entre -inf et inf. Par défaut, ces propriétés sont définies sur 0.

source : variant

Cette propriété définit l'élément qui sera rempli d'un dégradé. L'élément source est rendu dans un tampon de pixels intermédiaire et les valeurs d'opacité issues du résultat sont utilisées pour déterminer la visibilité des pixels du dégradé à l'écran. La valeur par défaut de « source » est indéfinie ; dans ce cas, toute la zone d'effet est remplie par le dégradé.

verticalOffset : real

Les propriétés « horizontalOffset » et « verticalOffset » définissent le décalage en pixels du point central du dégradé par rapport au centre de l'élément.

La valeur est comprise entre -inf et inf. Par défaut, ces propriétés sont définies sur 0.