Qt 5 兼容性 API：Qt 图形效果

Qt 图形效果模块提供用于与为 Qt 5 编写的应用程序兼容的功能。

注意：由于当效果层叠时 Qt 图形效果模块具有性能限制，因此它主要被包含以与 Qt 5 应用程序兼容。我们建议使用在 Qt 6 中引入的新效果解决方案编写新代码。对于典型的 UI 效果，Qt Quick 有 MultiEffect，它可以在一次遍历中应用多个效果。对于本组件未涵盖的高级用例，可以使用 Qt Quick 效果制作工具来自定义和精确调整所需的着色器效果。

使用 Qt 图形效果

效果是可作为 UI 组件添加到 Qt Quick 用户界面中的视觉项目。要导入 Qt 图形效果类型，通过在 QML 文件中添加以下语句包含 Qt 图形效果模块。

import Qt5Compat.GraphicalEffects

要使用效果，只需将特定的效果声明添加到 QML 场景中，并配置效果属性。源项目类型可以是任何 QML 类型，甚至是视频或其他效果。将多个效果一起流水线化是一个简单的方法来创建更令人印象深刻的结果。

以下列表显示了 Qt 图形效果中包含的类型的功能分区。

混合

混合	通过使用混合模式合并两个源项目

颜色

亮度对比度	调整亮度和对比度
颜色叠加	通过应用叠加颜色改变源项的颜色
着色	设置 HSL 颜色空间中的颜色
去饱和	降低颜色的饱和度
伽马调整	改变源项的亮度
色调饱和度	改变源项在 HSL 颜色空间中的颜色
级别调整	调整 RGBA 颜色空间中的颜色级别

渐变

锥形渐变	绘制锥形渐变
线性渐变	绘制线性渐变
径向渐变	绘制径向渐变

扭曲

位移	根据给定的位移映射移动源项的像素

下落阴影

下落阴影	在源项后面生成柔和的阴影
内阴影	在源项内部生成着色和模糊的阴影

模糊

快速模糊	将快速模糊效果应用于一个或多个源项
高斯模糊	应用高质量模糊效果
遮罩模糊	应用具有变化强度的模糊效果
递归模糊	反复模糊，提供强烈模糊效果

运动模糊

方向模糊	对指定方向应用模糊效果
径向模糊	在项目中心点周围以圆形方向应用方向模糊
缩放模糊	向源项目中心点应用方向模糊效果

发光

发光	生成源图像的模糊和彩色图像，并将其放置在原始图像后面，给人一种光源在发光的印象
矩形发光	生成模糊和彩色的矩形，给人一种源图像在发光的印象

遮罩

不透明遮罩	使用另一项对源项进行遮罩
阈值遮罩	使用另一项对源项进行遮罩，并应用阈值