RadialGradient QML Type

Dessine un dégradé radial. 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
• horizontalRadius : real
• source : variant
• verticalOffset : real
• verticalRadius : real

Description détaillée

Un dégradé est défini par deux couleurs ou plus, qui s'estompent progressivement les unes dans les autres. Les couleurs partent du centre de l'élément et s'étendent jusqu'aux bords.

Exemple

L'exemple suivant montre comment appliquer l'effet.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    RadialGradient {
        anchors.fill: parent
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 0.5; color: "black" }
        }
    }
}

Documentation sur les propriétés

angle : real

Cette propriété définit la rotation du dégradé autour de son point central. La rotation n'est visible que lorsque les propriétés « horizontalRadius » et « verticalRadius » ne sont pas égales. L'angle est exprimé en degrés et la valeur par défaut est « 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 mémoire supplémentaire est nécessaire pour stocker la sortie de l'effet.

Il est recommandé de désactiver la mise en 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 en douceur les unes dans les autres. 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 ainsi qu’une couleur. La position de chaque élément « GradientStop » est définie en configurant la propriété « position ». La couleur est définie en configurant 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.

Les valeurs vont de -inf à inf. Par défaut, ces propriétés sont définies sur 0.

horizontalRadius : real

Les propriétés `horizontalRadius` et ` verticalRadius ` définissent la forme et la taille du dégradé radial. Si les rayons sont égaux, le dégradé prend la forme d'un cercle. Si les rayons horizontal et vertical sont différents, la forme est elliptique. Les rayons sont exprimés en pixels.

La valeur est comprise entre -inf et inf. Par défaut, horizontalRadius est lié à la largeur et verticalRadius à la hauteur.

source : variant

Cette propriété définit l'élément qui sera rempli par 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 » n'est pas dé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.

Les valeurs vont de -inf à inf. Par défaut, ces propriétés sont définies sur 0.

verticalRadius : real

Les propriétés « horizontalRadius » et « verticalRadius » définissent la forme et la taille du dégradé radial. Si les rayons sont égaux, le dégradé prend la forme d’un cercle. Si les rayons horizontal et vertical sont différents, la forme est elliptique. Les rayons sont exprimés en pixels.

La valeur est comprise entre -inf et inf. Par défaut, la propriété horizontalRadius est liée à la largeur et la propriété verticalRadius est liée à la hauteur.