Qt 5 兼容 API：图形效果

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

Qt 图形效果模块提供一组 QML 类型，用于向用户界面添加视觉效果，并可根据需要进行配置。效果是可添加到 Qt Quick 用户界面作为 UI 组件的视觉项目。

该 API 由超过 20 个效果组成，以单独的 QML 类型提供。它们涵盖了如遮罩、模糊、着色等多个功能区域。

入门教程

要加载 Qt 图形效果，请在您的 .qml 文件中添加以下导入语句

import Qt5Compat.GraphicalEffects

要使用效果，请简单地向 QML 场景添加特定的效果声明，并配置效果属性。效果有一个或多个源属性，用于指定应用于视觉输入的效果。然后，修改后的视觉输出将在效果项目本身中呈现。源可以是在 QML 场景中的另一个，通常隐藏的项目。更复杂的效果可以有多个源。源项目类型可以是任何 QML 类型，甚至是视频或另一个效果。将多个效果结合在一起是一种简单的方法来创建甚至更令人印象深刻的效果输出。

每个效果都有一组属性，可以用来配置效果输出。属性可以像任何其他 QML 属性一样进行动画处理。QML 类型文档包含有关属性描述和基本用法示例的说明。

注意：使用 Qt Quick 的软件后端运行时，效果不可用。有关 Qt Quick 场景图后端更多信息，请参阅场景图适配。

注意：运行时生成的效果，如高斯模糊将使用 QTemporaryFile 在临时存储中存储着色器文件，因此需要可写的文件系统。

QML 类型

混合	通过使用混合模式合并两个源项目
亮度对比度	调整亮度和对比度
颜色叠加	通过应用叠加颜色更改源项目的颜色
着色	在 HSL 颜色空间中设置颜色
圆锥渐变	绘制圆锥渐变
降低饱和度	降低颜色的饱和度
方向模糊	在指定方向上应用模糊效果
位移	根据给定的位移图移动源项目的像素
阴影	在源项目后面生成阴影
快速模糊	将快速模糊效果应用于一个或多个源项目
伽马调整	更改源项目的亮度
高斯模糊	应用高质量模糊效果
光晕	生成并放置在原始图像后面的源项目的模糊和着色图像，给人一种发光的印象
色调饱和度	在 HSL 颜色空间中更改源项目颜色
内部阴影	在源文件中生成彩色和模糊的阴影
LevelAdjust	调整RGBA颜色空间中的颜色级别
LinearGradient	绘制线性渐变
MaskedBlur	应用强度变化的模糊效果
OpacityMask	使用另一个项遮罩源项
RadialBlur	在对源项中心点周围的圆形方向上应用方向性模糊
RadialGradient	绘制径向渐变
RectangularGlow	生成模糊并彩色的矩形，给人一种源项正在发光的印象
RecursiveBlur	重复模糊，提供强烈的模糊效果
ThresholdMask	使用另一个项遮罩源项并应用阈值值
ZoomBlur	对源项中心点应用方向性模糊效果

参考

QML 类型