RadialBlur QML Type

Wendet eine gerichtete Unschärfe in kreisförmiger Richtung um den Mittelpunkt des Elements an. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• angle : real
• cached : bool
• horizontalOffset : real
• samples : int
• source : variant
• transparentBorder : bool
• verticalOffset : real

Ausführliche Beschreibung

Der Effekt erweckt den Eindruck, dass sich das Ausgangselement in Richtung der Unschärfe zu drehen scheint.

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

Anwendungsbeispiel

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
    }

    RadialBlur {
        anchors.fill: bug
        source: bug
        samples: 24
        angle: 30
    }
}

Dokumentation zu den Eigenschaften

angle : real

Diese Eigenschaft legt die Richtung der Unschärfe und gleichzeitig den Grad der Unschärfe fest. Je größer der Winkel, desto stärker wird das Ergebnis unscharf. Die Qualität der Unschärfe hängt von der Eigenschaft „ samples “ ab. Bei einem großen Winkelwert sind mehr Abtastwerte erforderlich, um die visuelle Qualität auf einem hohen Niveau zu halten.

Zulässige Werte liegen zwischen 0,0 und 360,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 Quellen- oder Effekteigenschaften animiert werden.

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

horizontalOffset : real

Diese Eigenschaften legen den Versatz in Pixeln für den wahrgenommenen Mittelpunkt der Drehung fest.

Zulässige Werte liegen zwischen -inf und inf. Standardmäßig sind diese Eigenschaften auf „ 0 “ 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 unendlich (das praktische Maximum hängt von der GPU ab). Standardmäßig ist die Eigenschaft auf „ 0 “ (keine Abtastwerte) gesetzt.

source : variant

Diese Eigenschaft definiert das Quellelement, das unscharf gemacht 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 des Quellbereichs 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 Effektobjekts hinaus.

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

verticalOffset : real

Diese Eigenschaften legen den Versatz in Pixeln für den wahrgenommenen Mittelpunkt der Drehung fest.

Zulässige Werte liegen zwischen -inf und inf. Standardmäßig sind diese Eigenschaften auf „ 0 “ gesetzt.