径向模糊 QML 类型

在项目中心点周围以圆形方向应用方向模糊。更多...

导入语句	import Qt5Compat.GraphicalEffects
自从	Qt5Compat.GraphicalEffects 1.0
继承	Item

包括继承成员在内的所有成员列表

属性

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

详细信息

效果会给人一种源项仿佛旋转到模糊方向的印象。

其他可用的运动模糊效果有缩放模糊和方向模糊。

源	应用效果

注意：此效果在使用 OpenGL 运行时可用。

示例用法

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

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 : 实数

此属性定义了模糊的方向和同时模糊的程度。角度越大，结果越模糊。模糊的质量取决于 samples 属性。如果角度值较大，则需要更多的样本来保持高质量的视觉效果。

允许值介于 0.0 和 360.0 之间。默认情况下，属性设置为 0.0。

具有不同角度值的输出示例

angle: 0.0	angle: 15.0	angle: 30.0
samples: 24	samples: 24	samples: 24
horizontalOffset: 0	horizontalOffset: 0	horizontalOffset: 0
verticalOffset: 0	verticalOffset: 0	verticalOffset: 0

cached : 布尔值

此属性允许缓存效果输出像素，从而提高渲染性能。

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

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

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

horizontalOffset : 实数

这些属性定义了旋转的感知中心点偏移量（以像素为单位）。

允许的值介于负无穷大到无穷大。默认情况下，这些属性被设置为 0。

不同horizontalOffset值的输出示例

horizontalOffset: 75.0	horizontalOffset: 0.0	horizontalOffset: -75.0
samples: 24	samples: 24	samples: 24
angle: 20	angle: 20	angle: 20
verticalOffset: 0	verticalOffset: 0	verticalOffset: 0

samples : int

此属性定义在模糊计算过程中，每像素所取的样本数量。较大的值产生更好的质量，但渲染速度较慢。

此属性不打算用于动画。更改此属性可能会导致底层的OpenGL着色器重新编译。

允许的值介于0和无穷大（实际最大值取决于GPU）。默认情况下，此属性设置为 0（无样本）。

source : variant

此属性定义将要被模糊的源项。

注意：不支持让效果包括自身，例如通过将source设置为效果的父元素。

transparentBorder : bool

此属性定义在项目边缘附近模糊的行为，此时像素模糊受源边缘外像素的影响。

如果将此属性设置为 true，则源边缘外的像素被解释为透明，类似于OpenGL延伸到边界的扩展。模糊会在效果项目区域稍向外扩展。

如果将此属性设置为 false，则源边缘外的像素被视为与项目边缘上的像素颜色相同，类似于OpenGL钳位到边缘的行为。模糊不会在效果项目区域外扩展。

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

verticalOffset : real

这些属性定义了旋转的感知中心点偏移量（以像素为单位）。

允许的值介于负无穷大到无穷大。默认情况下，这些属性被设置为 0。

不同horizontalOffset值的输出示例

horizontalOffset: 75.0	horizontalOffset: 0.0	horizontalOffset: -75.0
samples: 24	samples: 24	samples: 24
angle: 20	angle: 20	angle: 20
verticalOffset: 0	verticalOffset: 0	verticalOffset: 0