Auf dieser Seite

FastBlur QML Type

Wendet einen schnellen Weichzeichner-Effekt auf ein oder mehrere Quellelemente an. Mehr...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Eigenschaften

Ausführliche Beschreibung

Hinweis: Die Komponente „ MultiEffect “ bietet einen Unschärfeeffekt mit einigen Leistungsvorteilen. Bei neuem Code sollte sie als Alternative zur Verwendung von Qt Graphical Effects in Betracht gezogen werden.

Der FastBlur-Effekt macht den Quellinhalt weicher, indem er ihn mit einem Algorithmus verwischt, der eine Verkleinerung des Quellinhalts und bilineare Filterung nutzt.

QuelleAngewandter Effekt

Schwarzer Käfer auf einem Blatt

Käfer mit Schnellunschärfe-Effekt

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 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 für die Speicherung der Effekt-Ausgabe ein zusätzlicher Speicherpuffer 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.

radius : real

Diese Eigenschaft legt den Abstand der benachbarten Pixel fest, 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 reduzieren, um eine gute Rendering-Leistung zu gewährleisten.

Der Wert reicht von 0,0 (keine Unschärfe) bis unendlich. Die visuelle Qualität der Unschärfe nimmt ab, wenn der Radius den Wert 64 überschreitet. Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Unschärfe) gesetzt.

Ausgabebeispiele mit verschiedenen Unschärfewerten

Käfer ohne Unschärfe

Käfer mit mäßiger Unschärfe

Käfer mit maximaler Unschärfe

Radius: 0 radius: 32 radius: 64

source : variant

Diese Eigenschaft legt das Quellelement fest, das unscharf dargestellt werden soll.

Hinweis: Es wird nicht unterstützt, den Effekt auf sich selbst anzuwenden, beispielsweise indem „source“ auf das übergeordnete Element des Effekts gesetzt wird.

transparentBorder : bool

Diese Eigenschaft legt das Unschärfeverhalten an den Rändern des Elements fest, wo die Pixelunschärfe 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 der Quelle so interpretiert, dass sie dieselbe Farbe wie die Pixel am Rand des Elements enthalten, 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.

Ausgabebeispiele mit unterschiedlichen „transparentBorder“-Werten

Weichzeichnung mit Kantenbegrenzung

Weichzeichnung mit transparenten Rändern

transparentBorder: false transparentBorder: true
radius: 64radius: 64

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.