Colorize QML Type

设置 HSL 色彩空间中的颜色。更多

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

属性

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

详细说明

该效果类似于在灰度图像上放置彩色玻璃时的效果。Colorize 使用色调、饱和度和亮度（HSL）色彩空间。你可以为每个属性指定一个所需的值。您可以通过HueSaturation 效果移动所有 HSL 值。

另外，您也可以使用ColorOverlay 效果在 RGBA 色彩空间中对源项目进行着色。

示例

下面的示例展示了如何应用该效果。

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
    }

    Colorize {
        anchors.fill: bug
        source: bug
        hue: 0.0
        saturation: 0.5
        lightness: -0.2
    }
}

属性文档

cached : bool

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

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

建议在动画源或特效属性时禁用缓存。

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

hue : real

该属性定义色调值，用于对信号源进行着色。

数值范围为 0.0 至 1.0。默认情况下，该属性设置为0.0 ，会产生微红色。

lightness : real

该属性定义光源亮度值的增减程度。

与色调和饱和度属性不同，亮度不设置使用值，而是移动现有的源像素亮度值。

数值范围为-1.0（降低）至 1.0（升高）。默认情况下，该属性设置为0.0 （不变）。

saturation : real

该属性定义了用于对信号源进行着色的饱和度值。

该值范围从 0.0（不饱和）到 1.0（饱和）。默认情况下，该属性设置为1.0 （饱和）。

source : variant

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