色调饱和度 QML 类型

调整 HSL 颜色空间中源项的颜色。 更多...

导入说明import Qt5Compat.GraphicalEffects
自QtGraphicalEffects 1.0
继承

Item

属性

详细描述

HueSaturation 与 Colorize 效果类似，但色调和饱和度属性值处理方式不同。HueSaturation 效果始终从原始值调整色调、饱和度和亮度，而不是设置它们。

来源应用效果

示例

以下示例展示了如何应用此效果。

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（无变化）。

不同色调值输出的示例

hue: -0.3hue: 0.0hue: 0.3
色调: 0色调: 0色调: 0
亮度: 0亮度: 0亮度: 0

lightness : real

此属性定义要添加到源亮度值的亮度值。

值范围为 -1.0（减少）到 1.0（增加）。默认情况下，该属性设置为 0.0（无变化）。

不同亮度值输出的示例

lightness: -0.5lightness: 0.0lightness: 0.5
色调: 0色调: 0色调: 0
色调: 0色调: 0色调: 0

saturation : real

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

值范围为 -1.0（减少）到 1.0（增加）。默认情况下，该属性设置为 0.0（无变化）。

不同饱和度值输出的示例

saturation: -0.8saturation: 0.0saturation: 1.0
色调: 0色调: 0色调: 0
亮度: 0亮度: 0亮度: 0

source : variant

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

注意：不允许效果包含自身，例如将源设置为效果的父级。


© 2024 Qt公司有限公司。本文件中包含的文档贡献均为相应所有者的版权。提供的文档依据自由软件基金会发布的《GNU自由文档许可协议》第1.3版许可使用。Qt及其相关标志是Qt公司Limited在芬兰以及其他国家/地区的商标。所有其他商标均为其相应所有者的财产。