RecursiveBlur QML Type
Verwischt wiederholt und erzeugt einen starken Unschärfe-Effekt. Mehr...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Eigenschaften
Ausführliche Beschreibung
Der Effekt RecursiveBlur macht das Bild weich, indem er es mit einem Algorithmus verwischt, der eine rekursive Rückkopplungsschleife verwendet, um die Quelle mehrfach zu verwischen. Der Effekt kann zu unschärferen Ergebnissen führen als GaussianBlur oder FastBlur, aber das Ergebnis wird asynchron erzeugt und benötigt mehr Zeit.
| Quelle | Angewandter Effekt |
|---|---|
|
|
Hinweis: Dieser Effekt ist nur bei der Ausführung mit OpenGL verfügbar.
Beispiel
Das folgende Beispiel zeigt, wie Sie den Effekt anwenden können.
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 } RecursiveBlur { anchors.fill: bug source: bug radius: 7.5 loops: 50 } }
Eigenschaft Dokumentation
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.
loops : int |
Diese Eigenschaft definiert die Anzahl der Weichzeichner-Iterationen, die für die Quelle durchgeführt werden. Wenn sich die Eigenschaft ändert, beginnt der iterative Unschärfeprozess. Wird der Wert verringert oder ändert sich der Wert von Null auf einen Wert ungleich Null, wird ein Schnappschuss von der Quelle gemacht. Der Schnappschuss wird als Startpunkt für den Prozess verwendet.
Die Iterationsschleife versucht, so schnell wie möglich zu laufen. Die Geschwindigkeit kann durch VSYNC oder die für einen Unschärfeschritt benötigte Zeit oder durch beides begrenzt sein. Manchmal kann es wünschenswert sein, die Unschärfe mit einer langsameren Geschwindigkeit durchzuführen. In diesem Fall kann es sinnvoll sein, die Eigenschaft mit Animation zu steuern, wodurch der Wert erhöht wird.
Der Wert reicht von 0 bis inf. Standardmäßig ist die Eigenschaft auf 0 eingestellt.
progress : real |
Diese Eigenschaft gibt den Fortschritt des asynchronen Weichzeichnungsverfahrens an, von 0,0 (nichts verwischt) bis 1,0 (fertig).
radius : real |
Diese Eigenschaft definiert den Abstand zwischen benachbarten Pixeln, die die Unschärfe der einzelnen Pixel beeinflussen. Ein größerer Radius bietet eine bessere Qualität, ist aber langsamer beim Rendern.
Hinweis: Der Radiuswert in diesem Effekt ist nicht dafür gedacht, häufig geändert oder animiert zu werden. Die korrekte Verwendung besteht darin, den richtigen Wert einzustellen und ihn für die gesamte Dauer der iterativen Unschärfesequenz unverändert zu lassen.
Der Wert reicht von (keine Unschärfe) bis 16,0 (maximale Unschärfestufe). Standardmäßig ist die Eigenschaft auf 0.0 (keine Unschärfe) eingestellt.
source : variant |
Diese Eigenschaft definiert das Quellobjekt, das unscharf gemacht werden soll.
Hinweis: Es wird nicht unterstützt, den Effekt sich selbst einschließen zu lassen, z. B. indem die Quelle auf das übergeordnete Element des Effekts gesetzt wird.
transparentBorder : bool |
Diese Eigenschaft definiert das Weichzeichnungsverhalten in der Nähe der Kanten des Elements, wobei die Pixelunschärfe von den Pixeln außerhalb der Quellenkanten 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.
© 2025 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.
