FastBlur QML Type

Wendet einen schnellen Unschärfeeffekt auf ein oder mehrere Quellobjekte an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• cached : bool
• radius : real
• source : variant
• transparentBorder : bool

Ausführliche Beschreibung

Der FastBlur-Effekt macht den Quellinhalt weich, indem er ihn mit einem Algorithmus verwischt, der die Herunterskalierung des Quellinhalts und bilineare Filterung verwendet.

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
    }

    FastBlur {
        anchors.fill: bug
        source: bug
        radius: 32
    }
}

Dokumentation der Eigenschaft

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 erhöht sich, da für die Speicherung der Effektausgabe ein zusätzlicher Speicherplatz benötigt wird.

Es wird empfohlen, den Cache zu deaktivieren, wenn die Quelle oder die Effekteigenschaften animiert werden.

Standardmäßig ist die Eigenschaft auf false eingestellt.

radius : real

Diese Eigenschaft definiert den Abstand der benachbarten Pixel, die die Unschärfe eines einzelnen Pixels beeinflussen. Ein größerer Radius verstärkt den Unschärfeeffekt. Der Algorithmus FastBlur kann die Genauigkeit des Radius intern verringern, um eine gute Rendering-Leistung zu erzielen.

Der Wert reicht von 0,0 (keine Unschärfe) bis inf. Die visuelle Qualität der Unschärfe wird reduziert, wenn der Radius den Wert 64 überschreitet. Standardmäßig ist die Eigenschaft auf 0.0 (keine Unschärfe) eingestellt.

source : variant

Diese Eigenschaft definiert das Quellobjekt, das unscharf gemacht werden soll.

transparentBorder : bool

Diese Eigenschaft definiert das Unschärfeverhalten in der Nähe der Kanten des Objekts, wobei die Pixelunschärfe von den Pixeln außerhalb der Quellkanten beeinflusst wird.

Wenn die Eigenschaft auf true gesetzt ist, werden die Pixel außerhalb der Quelle als transparent interpretiert, was der OpenGL-Clamp-to-border-Erweiterung ähnelt. Die Unschärfe wird außerhalb des Effektbereichs leicht erweitert.

Wenn die Eigenschaft auf false gesetzt ist, werden die Pixel außerhalb der Quelle so interpretiert, dass sie dieselbe Farbe enthalten wie die Pixel am Rand des Elements, was dem Verhalten von OpenGL Clamp-to-Edge ähnlich ist. Die Unschärfe dehnt sich nicht über den Bereich des Effektobjekts hinaus aus.

Standardmäßig ist die Eigenschaft auf false eingestellt.