FastBlur QML 类型

将快速模糊效果应用于一个或多个源项目。更多...

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

Item

属性

详细描述

FastBlur效果通过使用源内容的降尺度和双线性插值算法对源内容进行模糊，使其变软。

源应用了的效果

示例

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

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
    }

    FastBlur {
        anchors.fill: bug
        source: bug
        radius: 32
    }
}

属性文档

cached : bool

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

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

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

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


radius : real

此属性定义了影响单个像素模糊的相邻像素的距离。较大的半径会增加模糊效果。《FastBlur》算法可能会为良好的渲染性能而内部降低半径的精度。

范围从 0.0（无模糊）到无穷大。当半径超过 64 时，模糊的视觉质量将降低。默认情况下，该属性设置为 0.0（无模糊）。

具有不同模糊值的输出示例

radius: 0radius: 32radius: 64

source : variant

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

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


transparentBorder : bool

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

如果将属性设置为 true，则源外的像素将被解释为透明，这与 OpenGL 固定边缘扩展类似。模糊稍微扩展到效果项区域之外。

如果将属性设置为false，超出源区域的像素将被解释为与项目边缘的像素颜色相同，类似于OpenGL的钳边行为。模糊不会扩展到效果项目区域之外。

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

不同transparentBorder值的输出示例

transparentBorder: falsetransparentBorder: true
半径: 64半径: 64

版权（©）2024 Qt公司有限公司。此处包含的文档贡献为各自所有者的版权。本提供的文档遵循由自由软件基金会发布的GNU自由文档许可证第1.3版的条款。Qt及其相关商标为芬兰及全球其他国家的Qt公司有限公司的商标。所有其他商标均为各自所有者的财产。