Qt 5 Compatibility APIs:Graphical Effects

提供 QtGraphical Effects 模块是为了与为 Qt 5 编写的应用程序兼容。

QtGraphical Effects 模块提供了一组 QML 类型，用于为用户界面添加视觉效果出众且可配置的特效。特效是可作为用户界面组件添加到Qt Quick 用户界面的可视化项目。

注意： 由于 QtGraphical Effects 模块在特效堆叠时有性能限制，因此主要是为了与 Qt 5 应用程序兼容。我们建议使用 Qt 6 中引入的新特效解决方案之一编写新代码。对于典型的用户界面特效，Qt Quick 有MultiEffect ，它可以一次性应用多种特效。对于该组件未涵盖的高级用例，可使用Qt Quick Effect Maker 工具准确定制和微调所需的 Shader 效果。

使用 QtGraphical Effects

要导入 QtGraphical Effects 类型，请在 QML 文件中添加以下语句，以包含 QtGraphical Effects 模块：

import Qt5Compat.GraphicalEffects

要使用特效，只需在 QML 场景中添加特定特效声明并配置特效属性。特效有一个或多个源属性，用于指定应用特效的视觉输入。改变后的视觉输出将在特效项中呈现。源项类型可以是任何 QML 类型，甚至是视频或其他特效。将多个特效流水线连接在一起是创建更令人印象深刻的输出的简单方法。

下面的列表介绍了 Qt XMLGraphical Effects 部分类型的功能划分。

注：使用software 后端（Qt Quick ）运行时，特效不可用。有关Qt Quick 场景图后端的更多信息，请参阅场景图适配（Scene Graph Adaptations）。

注：运行时生成的特效（如GaussianBlur ）将使用QTemporaryFile 将着色器文件存储在临时存储空间中，因此它们需要一个可写文件系统。

混合

Blend

使用混合模式合并两个源项

色彩

BrightnessContrast	调整亮度和对比度
ColorOverlay	通过应用叠加色改变源项的颜色
Colorize	在 HSL 色彩空间中设置色彩
Desaturate	降低色彩饱和度
GammaAdjust	改变源项目的亮度
HueSaturation	更改 HSL 色彩空间中源项目的颜色
LevelAdjust	调整 RGBA 色彩空间中的色阶

渐变

ConicalGradient	绘制锥形渐变
LinearGradient	绘制线性渐变
RadialGradient	绘制径向渐变

变形

Displace

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

阴影

DropShadow	在源物件后方生成柔和阴影
InnerShadow	在源项内部生成彩色模糊阴影

模糊

FastBlur	对一个或多个源项应用快速模糊效果
GaussianBlur	应用更高质量的模糊效果
MaskedBlur	应用不同强度的模糊效果
RecursiveBlur	重复模糊，提供强烈的模糊效果

运动模糊

DirectionalBlur	对指定方向应用模糊效果
RadialBlur	在项目中心点周围的圆形方向上应用定向模糊效果
ZoomBlur	向源项目中心点应用定向模糊效果

发光

Glow	生成模糊和着色的源图像，并将其放在原始图像的后面，让人感觉源在发光
RectangularGlow	生成一个模糊并着色的矩形，给人一种源正在发光的感觉

蒙版

OpacityMask	用另一个项目屏蔽源项目
ThresholdMask	用另一个项目屏蔽源项目，并应用阈值

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.