ZoomBlur QML 类型

对源项中心点施加方向模糊效果。更多...

导入声明	import Qt5Compat.GraphicalEffects
自从	Qt5Compat.GraphicalEffects 1.0
继承	Item

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

属性

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

详细描述

效果令人产生源项似乎向 Z 轴中心点移动的印象，或者相机似乎正在快速缩放。其他可用的运动模糊效果是 DirectionalBlur 和 RadialBlur。

源	应用效果

注意： 此效果在配合 OpenGL 运行时才可用。

示例

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: butterfly
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ZoomBlur {
        anchors.fill: butterfly
        source: butterfly
        samples: 24
        length: 48
    }
}

属性文档

cached : bool

此属性允许缓存效果输出生成的像素以提高渲染性能。

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

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

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

horizontalOffset : real

这些属性定义了模糊方向中心点的像素偏移。

值范围为 -inf 到 inf。默认情况下，这些属性的值设置为 0。

不同 horizontalOffset 值的输出示例

horizontalOffset: 100.0	horizontalOffset: 0.0	horizontalOffset: -100.0
samples: 24	samples: 24	samples: 24
length: 32	length: 32	length: 32
verticalOffset: 0	verticalOffset: 0	verticalOffset: 0

length : real

此属性定义了每个像素感知到的最大移动量。此值在中心附近较小，并在边缘达到指定的值。

模糊质量取决于采样属性。如果长度值较大，则需要更多的样本以保持视觉效果。

值范围为 0.0 到无穷大。默认情况下，属性设置为 0.0（无模糊）。

不同长度值的输出示例

长度：0.0	长度：32.0	长度：48.0
samples: 24	samples: 24	samples: 24
水平偏移量: 0	水平偏移量: 0	水平偏移量: 0
verticalOffset: 0	verticalOffset: 0	verticalOffset: 0

samples : int

该属性定义在执行模糊计算时每个像素要采集多少样本。较大的值会产生更好的质量，但渲染速度较慢。

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

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

source : variant

该属性定义将要进行模糊的源项目。

注意：不支持让效果包含自身，例如通过将源设置为效果的父对象。

transparentBorder : bool

该属性定义项目边缘附近的模糊行为，其中像素模糊受源边缘之外的像素影响。

如果属性设置为 true，则源之外的像素被视为透明，类似于OpenGL的clampto-border扩展。模糊略微扩展到效果项目区域之外。

如果属性设置为 false，则源之外的像素被视为与项目边缘的像素具有相同的颜色，类似于OpenGL的clamp-to-edge行为。模糊不会扩展到效果项目区域之外。

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

verticalOffset : real

这些属性定义了模糊方向中心点的像素偏移。

值范围为 -inf 到 inf。默认情况下，这些属性的值设置为 0。

不同水平偏移量的输出示例

水平偏移量: 100.0	水平偏移量: 0.0	水平偏移量: -100.0
samples: 24	samples: 24	samples: 24
length: 32	length: 32	length: 32
垂直偏移量：0	垂直偏移量：0	垂直偏移量：0