DirectionalBlur QML Type

Wendet einen Weichzeichner-Effekt in der angegebenen Richtung an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• angle : real
• cached : bool
• length : real
• samples : int
• source : variant
• transparentBorder : bool

Ausführliche Beschreibung

Der Effekt erzeugt den Eindruck, dass sich das Quellobjekt in Richtung der Unschärfe zu bewegen scheint. Die Unschärfe wird auf beide Seiten jedes Pixels angewendet, daher führt die Einstellung der Richtung auf 0 und 180 zum gleichen Ergebnis.

Weitere verfügbare Bewegungsunschärfe-Effekte sind „ ZoomBlur “ und „ RadialBlur “.

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    DirectionalBlur {
        anchors.fill: bug
        source: bug
        angle: 90
        length: 32
        samples: 24
    }
}

Dokumentation zu den Eigenschaften

angle : real

Diese Eigenschaft legt die Richtung der Unschärfe fest. Die Unschärfe wird auf beide Seiten jedes Pixels angewendet, daher führt die Einstellung der Richtung auf 0 bzw. 180 zum gleichen Ergebnis.

Der Wert liegt im Bereich von -180,0 bis 180,0. Standardmäßig ist die Eigenschaft auf „ 0.0 “ gesetzt.

cached : bool

Mit dieser Eigenschaft können die Ausgabepixel 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.

length : real

Diese Eigenschaft legt das wahrgenommene Ausmaß der Bewegung für jedes Pixel fest. Die Bewegung wird gleichmäßig auf beide Seiten jedes Pixels verteilt.

Die Qualität der Unschärfe hängt von der Eigenschaft „ samples “ ab. Ist der Wert für „length“ groß, sind mehr Abtastpunkte erforderlich, um die visuelle Qualität auf einem hohen Niveau zu halten.

Der Wert reicht von 0,0 bis unendlich. Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Unschärfe) gesetzt.

samples : int

Diese Eigenschaft legt fest, wie viele Abtastwerte pro Pixel bei der Berechnung der Unschärfe erfasst werden. Ein höherer Wert führt zu einer besseren Qualität, verlangsamt jedoch die Darstellung.

Diese Eigenschaft ist nicht für Animationen vorgesehen. Eine Änderung dieser Eigenschaft kann dazu führen, dass die zugrunde liegenden OpenGL-Shader neu kompiliert werden.

Zulässige Werte liegen zwischen 0 und inf (das praktische Maximum hängt von der GPU ab). Standardmäßig ist die Eigenschaft auf „ 0 “ (keine Samples) gesetzt.

source : variant

Diese Eigenschaft definiert das Quellelement, das unscharf gestellt werden soll.

transparentBorder : bool

Diese Eigenschaft legt das Weichzeichnungsverhalten an den Rändern des Elements fest, wo die Pixelweichzeichnung durch die Pixel außerhalb der Quellränder beeinflusst wird.

Wenn die Eigenschaft auf „ true “ gesetzt ist, werden die Pixel außerhalb der Quelle als transparent interpretiert, was der OpenGL-Erweiterung „clamp-to-border“ ähnelt. Die Unschärfe wird leicht über den Bereich des Effektelements hinaus erweitert.

Wenn die Eigenschaft auf „ false “ gesetzt ist, werden die Pixel außerhalb des Quellbereichs so interpretiert, dass sie dieselbe Farbe wie die Pixel am Rand des Elements haben, was dem „clamp-to-edge“-Verhalten von OpenGL ähnelt. Die Unschärfe erstreckt sich nicht über den Bereich des Effektelements hinaus.

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