RadialBlur QML Type

在项目中心点周围的圆形区域内应用定向模糊效果。更多...

• 所有成员的列表，包括继承的成员

属性

• angle : real
• cached : bool
• horizontalOffset : real
• samples : int
• source : variant
• transparentBorder : bool
• verticalOffset : real

详细说明

该效果会营造出源对象仿佛正沿模糊方向旋转的视觉效果。

其他可用的运动模糊效果包括：ZoomBlur 和DirectionalBlur 。

使用示例

以下示例展示了如何应用该效果。

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
    }

    RadialBlur {
        anchors.fill: bug
        source: bug
        samples: 24
        angle: 30
    }
}

属性文档

angle : real

该属性定义了模糊的方向，同时也决定了模糊的程度。角度越大，效果就越模糊。模糊的质量取决于samples 属性。如果角度值较大，则需要更多的采样点才能保持较高的视觉质量。

允许的取值范围为 0.0 到 360.0。默认情况下，该属性设置为 `0.0`。

cached : bool

此属性允许将效果输出像素缓存起来，以提升渲染性能。

每次源或效果属性发生更改时，缓存中的像素都必须更新。由于需要额外的内存缓冲区来存储效果输出，因此内存消耗会增加。

当源或效果属性进行动画处理时，建议禁用缓存。

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

horizontalOffset : real

这些属性定义了旋转的视觉中心点的像素偏移量。

允许的取值范围在-inf到inf之间。默认情况下，这些属性设置为0 。

samples : int

该属性定义了在进行模糊计算时，每个像素取样多少次。数值越大，质量越高，但渲染速度越慢。

该属性不支持动画效果。更改此属性可能会导致底层的 OpenGL 着色器被重新编译。

允许的取值范围为 0 到 inf（实际最大值取决于 GPU）。默认情况下，该属性设置为0 （不进行采样）。

source : variant

此属性用于指定将被模糊处理的源项目。

transparentBorder : bool

该属性定义了项目边缘附近的模糊行为，此时像素的模糊效果会受到源边缘外部像素的影响。

如果将该属性设置为true ，则源区域外的像素将被解释为透明，这类似于 OpenGL 的“clamp-to-border”扩展。模糊效果会稍微扩展到效果项区域之外。

如果将该属性设置为 `false`，则源区域外的像素将被解释为包含与项目边缘像素相同的颜色，这类似于 OpenGL 的“clamp-to-edge”行为。模糊效果不会扩展到效果项目区域之外。

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

verticalOffset : real

这些属性定义了旋转的视觉中心点的像素偏移量。

允许的取值范围在 -inf 到 inf 之间。默认情况下，这些属性设置为0 。