DropShadow QML Type

该属性允许缓存效果输出像素，以提高渲染性能。每次更改源或特效属性时，都必须更新缓存中的像素。由于需要额外的内存缓冲区来存储效果输出，因此会增加内存消耗。

建议在动画源或特效属性时禁用缓存。

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

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

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

HorizontalOffset 和verticalOffset 属性定义了渲染阴影相对于DropShadow 项位置的偏移量。通常情况下，DropShadow 项目会被锚定，以填充源元素。在这种情况下，如果 HorizontalOffset 和verticalOffset 属性设置为 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 。