HueSaturation QML Type

在HSL色彩空间中更改源项的颜色。更多...

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

属性

• cached : bool
• hue : real
• lightness : real
• saturation : real
• source : variant

详细说明

“色相饱和度”（HueSaturation）与“色相饱和度”（Colorize ）效果类似，但对色相和饱和度属性值的处理方式不同。“色相饱和度”效果始终会调整原始值的色相、饱和度和明度，而非直接设置这些属性值。

示例

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

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
    }

    HueSaturation {
        anchors.fill: bug
        source: bug
        hue: -0.3
        saturation: 0.5
        lightness: -0.1
    }
}

属性文档

cached : bool

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

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

当源或效果属性进行动画处理时，建议禁用缓存。

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

hue : real

此属性定义了要添加到源色相值上的色相值。

该值的取值范围为-1.0（降低）到1.0（提高）。默认情况下，该属性设置为0.0 （保持不变）。

lightness : real

此属性定义了要加到源饱和度值上的明度值。

该值范围为 -1.0（降低）到 1.0（提高）。默认情况下，该属性设置为0.0 （无变化）。

saturation : real

此属性定义了要加到源饱和度值上的饱和度值。

该值范围为 -1.0（降低）到 1.0（提高）。默认情况下，该属性设置为0.0 （保持不变）。

source : variant

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