LevelAdjust QML Type

调整 RGBA 色彩空间中的颜色级别。更多...

• 所有成员的列表，包括继承的成员

属性

• cached : bool
• gamma : variant
• maximumInput : color
• maximumOutput : color
• minimumInput : color
• minimumOutput : color
• source : variant

详细说明

此效果可针对源对象的每个颜色通道分别调整其颜色。可以调整源对象的对比度并改变其色彩平衡。

示例

以下示例演示了如何应用该效果。

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: butterfly
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    LevelAdjust {
        anchors.fill: butterfly
        source: butterfly
        minimumOutput: "#00ffffff"
        maximumOutput: "#ff000000"
    }
}

属性文档

cached : bool

此属性允许将效果输出像素缓存起来，以提升渲染性能。

每次更改源或效果属性时，缓存中的像素都必须更新。由于需要额外的内存缓冲区来存储效果输出，因此内存消耗会增加。

当源或效果属性被动画化时，建议禁用缓存。

默认情况下，该属性设置为false 。

gamma : variant

该属性定义了每个像素颜色通道的值根据以下公式发生变化的调整因子：

result.rgb = pow(original.rgb, 1.0 / gamma.rgb);

将伽马值设置为小于或等于 QtVector3d(1.0, 1.0, 1.0) 会使图像变暗，大于 QtVector3d(1.0, 1.0, 1.0) 则会使图像变亮。

该值的取值范围从 QtVector3d(0.0, 0.0, 0.0)（最暗）到 inf（最亮）。默认情况下，该属性设置为QtVector3d(1.0, 1.0, 1.0) （无变化）。

maximumInput : color

此属性定义了每个颜色通道的最大输入电平。它设定了白点，所有值高于该属性的像素（按颜色通道计算）都会被渲染为白色。降低该值会使亮部区域变亮。

该值的取值范围为“#ffffffff”至“#00000000”。默认情况下，该属性设置为"#ffffffff" （保持不变）。

maximumOutput : color

此属性定义了每个颜色通道的最大输出电平。减小该值会使亮部变暗，从而降低对比度。

该值的取值范围为“#ffffffff”至“#00000000”。默认情况下，该属性设置为"#ffffffff" （不作更改）。

minimumInput : color

此属性定义了每个颜色通道的最低输入电平。它用于设置黑点，所有值低于该属性的像素（按颜色通道计算）都会被渲染为黑色。增加该值会使暗部区域变暗。

该值的取值范围为“#00000000”至“#ffffffff”。默认情况下，该属性设置为"#00000000" （保持不变）。

minimumOutput : color

此属性定义了每个颜色通道的最小输出电平。增加该值会使暗部变亮，从而降低对比度。

该值的取值范围为“#00000000”至“#ffffffff”。默认情况下，该属性设置为"#00000000" （无变化）。

source : variant

此属性定义了为该效果提供源像素的源项。