LinearGradient QML Type

Zeichnet einen linearen Farbverlauf. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Ein Farbverlauf wird durch zwei oder mehr Farben definiert, die nahtlos ineinander übergehen. Die Farben beginnen am angegebenen Startpunkt und enden am angegebenen Endpunkt.

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

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

Dokumentation der Eigenschaften

cached : bool

Mit dieser Eigenschaft können die Ausgangspixel des Effekts zwischengespeichert werden, 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.

end : variant

Diese Eigenschaft definiert den Endpunkt, an dem die Farbe bei einer Farbverlaufsposition von 1,0 dargestellt wird. Farben bei kleineren Positionswerten werden linear in Richtung des Startpunkts dargestellt. Der Punkt wird in Pixeln angegeben, und der Standardwert ist Qt.point(0, height). Durch Festlegen der Standardwerte für „ start “ und „end“ entsteht ein linearer Farbverlauf über die gesamte Höhe entlang der y-Achse.

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 zwischen 0,0 und 1,0 sowie eine Farbe definiert. Die Position jedes „ GradientStop “-Elements wird durch die Eigenschaft „position“ festgelegt, die Farbe durch die Eigenschaft „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

Diese Eigenschaft legt das Element fest, das mit einem Farbverlauf gefüllt werden soll. Das Quellelement wird in einen Zwischenpixelpuffer 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.

start : variant

Diese Eigenschaft definiert den Startpunkt, an dem die Farbe bei der Verlaufsposition 0,0 dargestellt wird. Farben bei größeren Positionswerten werden linear in Richtung des Endpunkts dargestellt. Der Punkt wird in Pixeln angegeben, und der Standardwert ist Qt.point(0, 0). Das Festlegen der Standardwerte für den Start- und end zu einem linearen Farbverlauf über die gesamte Höhe auf der y-Achse.