QML 图形渲染 - BrightnessContrast

作者：billy
版权声明：著作权归作者所有，商业转载请联系作者获得授权，非商业转载请注明出处

属性介绍

• brightness : real
  光源亮度的增加或减少程度。该值的范围为 -1.0 到 1.0。默认情况下，该值为 0.0

• cached : bool
  使用缓存效果输出像素，可以提高渲染性能。每次更改源或效果属性时，都必须更新缓存中的像素。会增加内存消耗，因为存储效果输出需要额外的内存缓冲区。所以我们建议在源属性或效果属性设置动画时禁用缓存。默认为 false

• contrast : real
  源对比度增加或减少的程度。对比度的降低是线性的，但增加是通过非线性曲线应用的，以允许在值范围的高端进行非常高的对比度调整。该值的范围为 -1.0 到 1.0。默认情况下，该值为 0.0

• source : variant
  为效果提供源像素的源项。注意：不支持让效果包含自身

注意事项

1. BrightnessContrast 支持 OpenGL 渲染
2. BrightnessContrast 可调整源项的颜色。亮度调整更改源项的感知亮度。对比度调整增加或减少颜色和亮度变化

不同数值效果展示

官方示例

import QtQuick 2.12
import QtGraphicalEffects 1.12

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
    }
}