在QML中,LevelAdjust
是 QtGraphicalEffects
模块中的一个元素,用于通过调整输入和输出范围(色阶)以及伽马值来精确控制图像的亮度、对比度和色彩分布。它类似于图像编辑软件中的“色阶调整”功能,适用于修复曝光问题、增强对比度或实现风格化效果。以下是其使用技巧和关键点:
1. 基本用法
导入模块并设置色阶参数:
import QtGraphicalEffects 1.0
LevelAdjust {
width: 200
height: 200
// 输入源(支持任意Item类型)
source: Image { source: "image.png" }
// 核心属性:输入/输出范围及伽马值
minimumInput: 0.0 // 输入最小值(0.0~1.0)
maximumInput: 1.0 // 输入最大值(≥minimumInput)
minimumOutput: 0.0 // 输出最小值(0.0~1.0)
maximumOutput: 1.0 // 输出最大值(≥minimumOutput)
gamma: 1.0 // 伽马校正(>0.0,默认1.0)
// 可选:启用缓存优化性能
cached: true
}
2. 关键属性详解
-
minimumInput
和maximumInput
- 定义输入像素值的范围。小于
minimumInput
的值会被裁剪,大于maximumInput
的值会被限制。<
- 定义输入像素值的范围。小于