ConicalGradient QML Type

Zeichnet einen konischen Farbverlauf. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

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

Ausführliche Beschreibung

Ein Farbverlauf wird durch zwei oder mehr Farben definiert, die nahtlos ineinander übergehen. Die Farben beginnen bei dem angegebenen Winkel und enden bei einem um 360 Grad größeren Winkelwert.

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

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

Dokumentation der Eigenschaften

angle : real

Diese Eigenschaft definiert den Startwinkel, bei dem die Farbe an der Gradientenposition 0,0 dargestellt wird. Farben bei größeren Positionswerten werden in größeren Winkelwerten dargestellt und nahtlos ineinander überblendet. Die Winkelwerte steigen im Uhrzeigersinn an.

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 Elementen vom Typ „ GradientStop “ angegeben, von denen jedes eine Position auf dem Farbverlauf (von 0,0 bis 1,0) und eine Farbe definiert. Die Position jedes „ GradientStop “-Elements wird durch die Eigenschaft „position“ festgelegt. Die Farbe wird durch die 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 Mittelpunktes des Farbverlaufs in Pixeln relativ zur Mitte des Elements fest.

Der Wert reicht von -inf bis inf. Standardmäßig sind die Eigenschaften auf „ 0 “ gesetzt.

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 die Alpha-Werte aus dem Ergebnis werden verwendet, um die Sichtbarkeit der Pixel des Farbverlaufs auf dem Bildschirm zu bestimmen. 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 in Pixeln für den Mittelpunkt des Farbverlaufs im Verhältnis zur Mitte des Elements fest.

Der Wert reicht von -inf bis inf. Standardmäßig sind die Eigenschaften auf „ 0 “ gesetzt.