ZoomBlur QML Type
Wendet einen gerichteten Unschärfeeffekt in Richtung des Mittelpunkts des Quellobjekts an. Mehr...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | Qt5Compat.GraphicalEffects 1.0 |
| Inherits: |
Eigenschaften
- cached : bool
- horizontalOffset : real
- length : real
- samples : int
- source : variant
- transparentBorder : bool
- verticalOffset : real
Detaillierte Beschreibung
Der Effekt erweckt den Eindruck, dass sich das Quellobjekt in Z-Richtung auf den Mittelpunkt zu bewegen scheint oder dass die Kamera schnell zu zoomen scheint. Weitere verfügbare Bewegungsunschärfe-Effekte sind DirectionalBlur und RadialBlur.
| Quelle | Angewandter Effekt |
|---|---|
|
|
Hinweis: Dieser Effekt ist 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: 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 } }
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.
horizontalOffset : real |
Diese Eigenschaften definieren einen Versatz in Pixeln für den Mittelpunkt der Unschärferichtung.
Die Werte reichen von -inf bis inf. Standardmäßig sind diese Eigenschaften auf 0 eingestellt.
| Ausgabebeispiele mit verschiedenen horizontalOffset-Werten | ||
|---|---|---|
|
|
|
| horizontalAbweichung: 100.0 | horizontalOffset: 0.0 | horizontalOffset: -100.0 |
| samples: 24 | samples: 24 | samples: 24 |
| length: 32 | length: 32 | length: 32 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
length : real |
Diese Eigenschaft definiert den maximalen wahrgenommenen Betrag der Bewegung für jedes Pixel. Der Betrag ist in der Nähe der Mitte kleiner und erreicht an den Rändern den angegebenen Wert.
Die Qualität der Unschärfe hängt von der Eigenschaft samples ab. Wenn der Wert für die Länge groß ist, werden mehr Samples benötigt, um die visuelle Qualität auf hohem Niveau zu halten.
Der Wert reicht von 0.0 bis inf. Standardmäßig ist die Eigenschaft auf 0.0 (keine Unschärfe) eingestellt.
| Ausgabebeispiele mit verschiedenen Längenwerten | ||
|---|---|---|
|
|
|
| Länge: 0.0 | Länge: 32.0 | Länge: 48.0 |
| samples: 24 | samples: 24 | samples: 24 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
samples : int |
Diese Eigenschaft legt fest, wie viele Stichproben pro Pixel bei der Berechnung der Unschärfe genommen werden. Ein größerer Wert ergibt eine bessere Qualität, ist aber langsamer beim Rendern.
Diese Eigenschaft ist nicht für Animationen gedacht. Das Ändern dieser Eigenschaft kann dazu führen, dass die zugrunde liegenden OpenGL-Shader neu kompiliert werden müssen.
Erlaubte Werte liegen zwischen 0 und inf (das praktische Maximum hängt von der GPU ab). Standardmäßig ist die Eigenschaft auf 0 (keine Muster) eingestellt.
source : variant |
Diese Eigenschaft definiert das Quell-Element, 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 Kanten der Quelle 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.
verticalOffset : real |
Diese Eigenschaften definieren einen Versatz in Pixeln für den Mittelpunkt der Unschärferichtung.
Die Werte reichen von -inf bis inf. Standardmäßig sind diese Eigenschaften auf 0 eingestellt.
| Ausgabebeispiele mit verschiedenen horizontalOffset Werten | ||
|---|---|---|
|
|
|
| horizontalOffset: 100.0 | horizontalOffset: 0.0 | horizontalOffset: -100.0 |
| samples: 24 | samples: 24 | samples: 24 |
| length: 32 | length: 32 | length: 32 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
© 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.
