DropShadow QML 类型

此属性允许将效果输出像素缓存以改进渲染性能。每次更改源或效果属性时，必须在缓存中更新像素。由于需要存储效果的输出，内存消耗有所增加。

当源或效果属性为动画时，建议关闭缓存。

默认情况下，该属性设置为 false。

此属性定义用于阴影的 RGBA 颜色值。

默认情况下，属性设置为 "black"。

水平偏移和 垂直偏移 属性定义了相对于 DropShadow 项目的位置渲染阴影的偏移量。通常，DropShadow 项被锚定以便填充源元素。在这种情况下，如果水平偏移和垂直偏移属性被设置为 0，则阴影正好渲染在源项目下方。通过更改偏移属性，可以相对于源项目定位阴影。

值范围从 -inf 到 inf。默认情况下，属性被设置为 0。

半径定义了阴影的柔和度。较大的半径会导致阴影的边缘更加模糊。

通过选择合适的 samples 和 radius 以达到理想的模糊效果，例如 samples = 1 + radius * 2，如下所示：

默认情况下，该属性被设置为 floor(samples/2)。

此属性定义在边缘软化模糊计算时每个像素的采样数。较大的值产生更好的质量，但渲染速度较慢。

理想情况下，此值应为所需的最大半径值的两倍加一，例如

默认情况下，该属性被设置为 9。

此属性不适合动画。更改此属性会导致底层的 OpenGL 着色器重新编译。

此属性定义了要作为生成阴影源的项目。

此属性定义了在源边缘附近阴影颜色加强的程度。

值范围为 0.0 到 1.0。默认情况下，该属性被设置为 0.0。

此属性确定效果是否有透明边框。

当设置为 true 时，项目的最外层填充了一个宽 1 像素的不透明边框，这使得在源纹理外部采样使用透明度而不是边缘像素。如果没有此属性，具有不透明边缘的图像将不会得到模糊阴影。

在下面的图像中，左边的矩形具有透明边框且边缘模糊，而右边的矩形则没有

默认情况下，此属性被设置为 true。

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
            }
        }
    }
}

HorizontalOffset 和 verticalOffset 属性定义了与 DropShadow 项位置相比所渲染阴影的偏移量。通常，DropShadow 项会被锚定以填充源元素。在这种情况下，如果将 HorizontalOffset 和 verticalOffset 属性设置为 0，则阴影将渲染在源项正下方。通过改变偏移量属性，可以将阴影相对于源项进行定位。

值范围从 -inf 到 inf。默认情况下，属性被设置为 0。