RadialGradient QML Type

Zeichnet einen radialen Farbverlauf. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Ein Farbverlauf wird durch zwei oder mehr Farben definiert, die nahtlos ineinander übergehen. Die Farben beginnen in der Mitte des Elements und enden an den Rändern.

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

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

Eigenschaftsdokumentation

angle : real

Diese Eigenschaft definiert die Drehung des Farbverlaufs um seinen Mittelpunkt. Die Drehung ist nur sichtbar, wenn die Eigenschaften „ horizontalRadius “ und „ verticalRadius “ ungleich sind. Der Winkel wird in Grad angegeben, und der Standardwert lautet „ 0 “.

cached : bool

Diese Eigenschaft ermöglicht es, die Ausgabepixel des Effekts zwischenzuspeichern, um die Rendering-Leistung zu verbessern.

Jedes Mal, wenn die Eigenschaften der Quelle oder des Effekts geändert werden, müssen die Pixel im Cache aktualisiert werden. Der Speicherverbrauch steigt, da ein zusätzlicher Speicherpuffer zum Speichern der Effekt-Ausgabe benötigt wird.

Es wird empfohlen, den Cache zu deaktivieren, wenn die Eigenschaften der Quelle oder des Effekts animiert werden.

Standardmäßig ist die Eigenschaft auf „ false “ gesetzt.

gradient : Gradient

Ein Farbverlauf wird durch zwei oder mehr Farben definiert, die nahtlos ineinander übergehen. Die Farben werden als eine Reihe von untergeordneten „ GradientStop “-Elementen angegeben, von denen jedes eine Position auf dem Farbverlauf zwischen 0,0 und 1,0 sowie eine Farbe definiert. Die Position jedes „ GradientStop “-Elements wird durch die Einstellung der Eigenschaft „position“ festgelegt. Die Farbe wird durch die Einstellung der Eigenschaft „color“ festgelegt.

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

Die Eigenschaften „horizontalOffset“ und „ verticalOffset “ legen den Versatz des Mittelpunkts des Farbverlaufs in Pixeln relativ zur Mitte des Elements fest.

Die Werte reichen von -inf bis inf. Standardmäßig sind diese Eigenschaften auf „ 0 “ gesetzt.

horizontalRadius : real

Die Eigenschaften „horizontalRadius“ und „ verticalRadius “ legen die Form und Größe des radialen Farbverlaufs fest. Sind die Radien gleich groß, hat der Farbverlauf die Form eines Kreises. Unterscheiden sich der horizontale und der vertikale Radius, ist die Form elliptisch. Die Radien werden in Pixeln angegeben.

Der Wert reicht von -inf bis inf. Standardmäßig ist „horizontalRadius“ an die Breite und „ verticalRadius “ an die Höhe gebunden.

source : variant

Diese Eigenschaft legt das Element fest, das mit einem Farbverlauf gefüllt werden soll. Das Quellelement wird in einen temporären Pixelpuffer gerendert, und anhand der daraus resultierenden Alpha-Werte wird bestimmt, inwieweit die Pixel des Farbverlaufs auf dem Bildschirm sichtbar sind. Der Standardwert für „source“ ist nicht definiert; in diesem Fall wird der gesamte Effektbereich mit dem Farbverlauf gefüllt.

verticalOffset : real

Die Eigenschaften „ horizontalOffset “ und „verticalOffset“ legen den Versatz des Mittelpunkts des Farbverlaufs in Pixeln relativ zur Mitte des Elements fest.

Die Werte reichen von -inf bis inf. Standardmäßig sind diese Eigenschaften auf „ 0 “ gesetzt.

verticalRadius : real

Die Eigenschaften „ horizontalRadius “ und „verticalRadius“ legen die Form und Größe des radialen Farbverlaufs fest. Sind die Radien gleich groß, hat der Farbverlauf die Form eines Kreises. Unterscheiden sich der horizontale und der vertikale Radius, ist die Form elliptisch. Die Radien werden in Pixeln angegeben.

Der Wertebereich reicht von -inf bis inf. Standardmäßig ist „ horizontalRadius “ an die Breite und „verticalRadius“ an die Höhe gebunden.