DropShadow QML Type

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.

Diese Eigenschaft definiert den RGBA-Farbwert, der für den Schatten verwendet wird.

Standardmäßig ist die Eigenschaft auf "black" eingestellt.

Die Eigenschaften HorizontalOffset und verticalOffset legen den Versatz des gerenderten Schattens im Vergleich zur Position des Elements DropShadow fest. Häufig ist das Element DropShadow so verankert, dass es das Quellelement ausfüllt. Wenn in diesem Fall die Eigenschaften HorizontalOffset und verticalOffset auf 0 gesetzt sind, wird der Schatten genau unter dem Quellelement gerendert. Durch Ändern der Offset-Eigenschaften kann der Schatten relativ zum Quellelement positioniert werden.

Die Werte reichen von -inf bis inf. Standardmäßig sind die Eigenschaften auf 0 eingestellt.

Der Radius bestimmt die Weichheit des Schattens. Ein größerer Radius lässt die Kanten des Schattens unschärfer erscheinen.

Die ideale Unschärfe wird erreicht, indem samples und radius so gewählt werden, dass samples = 1 + radius * 2, z. B:

Standardmäßig ist die Eigenschaft auf floor(samples/2) eingestellt.

Diese Eigenschaft legt fest, wie viele Abtastungen pro Pixel bei der Berechnung der Kantenweichzeichnung vorgenommen werden. Ein größerer Wert ergibt eine bessere Qualität, ist aber langsamer beim Rendern.

Idealerweise sollte dieser Wert doppelt so groß sein wie der höchste erforderliche Radiuswert plus eins, z. B.:

Standardmäßig ist die Eigenschaft auf 9 eingestellt.

Diese Eigenschaft soll nicht animiert werden. Das Ändern dieser Eigenschaft führt dazu, dass die zugrunde liegenden OpenGL-Shader neu kompiliert werden.

Diese Eigenschaft definiert das Quellelement, das als Quelle für den erzeugten Schatten verwendet werden soll.

Diese Eigenschaft legt fest, wie stark ein Teil der Schattenfarbe in der Nähe der Quellkanten verstärkt wird.

Der Wert reicht von 0,0 bis 1,0. Standardmäßig ist die Eigenschaft auf 0.0 eingestellt.

Diese Eigenschaft bestimmt, ob der Effekt einen transparenten Rand hat oder nicht.

Wenn sie auf true gesetzt ist, wird die Außenseite des Objekts mit einem 1 Pixel breiten transparenten Rand aufgefüllt, so dass die Abtastung außerhalb der Quelltextur die Transparenz anstelle der Randpixel verwendet. Ohne diese Eigenschaft erhält ein Bild mit undurchsichtigen Kanten keinen unscharfen Schatten.

In der folgenden Abbildung hat das Rechteck auf der linken Seite transparente Ränder und unscharfe Kanten, während das Rechteck auf der rechten Seite dies nicht hat:

Standardmäßig ist diese Eigenschaft auf true eingestellt.

import QtQuick
import Qt5Compat.GraphicalEffects

Rectangle {
    width: 180
    height: 100

    Row {
        anchors.centerIn: parent
        spacing: 16

        Rectangle {
            id: normalRect
            width: 60
            height: 60
            radius: 10
            color: "steelblue"
            layer.enabled: true
            layer.effect: DropShadow {
                transparentBorder: false
                horizontalOffset: 8
                verticalOffset: 8
            }
        }

        Rectangle {
            id: transparentBorderRect
            width: 60
            height: 60
            radius: 10
            color: "steelblue"
            layer.enabled: true
            layer.effect: DropShadow {
                transparentBorder: true
                horizontalOffset: 8
                verticalOffset: 8
            }
        }
    }
}

Die Eigenschaften HorizontalOffset und VerticalOffset definieren den Versatz des gerenderten Schattens im Vergleich zur Position des Elements DropShadow. Häufig ist das Element DropShadow so verankert, dass es das Quellelement ausfüllt. Wenn in diesem Fall die Eigenschaften HorizontalOffset und verticalOffset auf 0 gesetzt werden, wird der Schatten genau unter dem Quellelement gerendert. Durch Ändern der Offset-Eigenschaften kann der Schatten relativ zum Ausgangselement positioniert werden.

Die Werte reichen von -inf bis inf. Standardmäßig sind die Eigenschaften auf 0 eingestellt.