BrightnessContrast QML Type
调整亮度和对比度。更多
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
属性
- brightness : real
- cached : bool
- contrast : real
- source : variant
详细说明
注意: MultiEffect 组件提供了具有一定性能优势的亮度和对比度效果。对于新代码,应考虑将其作为使用 Qt XMLGraphical Effects 的替代方案。
该效果可调整源项目的颜色。亮度调整可改变源项目的感知亮度。对比度调整可增加或减少颜色和亮度变化。
| 来源 | 应用的效果 |
|---|---|
|
|
示例
下面的示例显示了如何应用效果。
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 } BrightnessContrast { anchors.fill: bug source: bug brightness: 0.5 contrast: 0.5 } }
属性文档
brightness : real
该属性定义光源亮度的增减程度。
数值范围为-1.0 至 1.0。默认情况下,该属性设置为0.0 (不变)。
cached : bool
此属性允许缓存效果输出像素,以提高渲染性能。
每次更改源或效果属性时,都必须更新缓存中的像素。由于需要额外的内存缓冲区来存储效果输出,因此会增加内存消耗。
建议在动画源或特效属性时禁用缓存。
默认情况下,该属性设置为false 。
contrast : real
该属性定义了信号源对比度的增减幅度。对比度的降低是线性的,但增加则采用非线性曲线,以便在数值范围的高端进行非常高的对比度调整。
| 对比度调节曲线 |
|---|
|
数值范围为-1.0 至 1.0。默认情况下,该属性设置为0.0 (无变化)。
| 不同对比度值的输出示例 | ||
|---|---|---|
|
|
|
| 对比度:-0.5 | 对比度:0 | 对比度:0.5 |
| brightness:0 | brightness:0 | brightness:0 |
source : variant
此属性定义了为效果提供源像素的源项。
注意: 不支持让效果包含自身,例如将源设置为效果的父项。
© 2026 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.








