ZoomBlur QML Type

Wendet einen gerichteten Unschärfeeffekt auf den Mittelpunkt der Quellelemente an. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

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

Ausführliche Beschreibung

Der Effekt erweckt den Eindruck, dass sich das Quellobjekt in Z-Richtung auf den Mittelpunkt zu bewegt oder dass die Kamera schnell zoomt. Weitere verfügbare Bewegungsunschärfeeffekte sind „ DirectionalBlur “ und „ RadialBlur “.

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    ZoomBlur {
        anchors.fill: butterfly
        source: butterfly
        samples: 24
        length: 48
    }
}

Dokumentation der Eigenschaften

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.

horizontalOffset : real

Diese Eigenschaften legen einen Versatz in Pixeln für den Mittelpunkt der Unschärferichtung fest.

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

length : real

Diese Eigenschaft legt das maximale wahrgenommene Bewegungsmaß für jedes Pixel fest. Dieses Maß ist in der Mitte geringer und erreicht an den Rändern den angegebenen Wert.

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

Der Wert liegt im Bereich 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 Abtastwerte) gesetzt.

source : variant

Diese Eigenschaft definiert das Quellelement, das unscharfgestellt 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 der Quelle so interpretiert, als hätten sie dieselbe Farbe wie die Pixel am Rand des Elements, 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.

verticalOffset : real

Diese Eigenschaften legen einen Versatz in Pixeln für den Mittelpunkt der Unschärferichtung fest.

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