Colorize QML Type

HSL 색 공간에서 색을 설정합니다. 더 보기...

Import Statement:	`import Qt5Compat.GraphicalEffects`
Since:	QtGraphicalEffects 1.0
Inherits:	Item

상속된 멤버를 포함한 모든 멤버 목록

속성

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

자세한 설명

이 효과는 그레이 스케일 이미지 위에 컬러 유리잔을 올려놓았을 때 나타나는 효과와 유사합니다. 색상화는 색조, 채도 및 명도(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 으로 설정되어 있습니다.

허용되는 색조 값

색조 값이 다른 출력 예제

hue: 0.2	hue: 0.5	hue: 0.8
saturation: 1	saturation: 1	saturation: 1
lightness: 0	lightness: 0	lightness: 0

lightness : real

이 속성은 소스 밝기 값을 얼마나 늘리거나 줄일지 정의합니다.

색조 및 채도 속성과 달리 밝기는 사용 값을 설정하지 않고 기존 소스 픽셀 밝기 값을 이동합니다.

값의 범위는 -1.0(감소)에서 1.0(증가)입니다. 기본적으로 이 속성은 0.0 (변경 없음)로 설정되어 있습니다.

밝기 값이 다른 출력 예시

밝기: -0.75	밝기: 0	밝기: 0.75
hue: 0	hue: 0	hue: 0
saturation: 1	saturation: 1	saturation: 1

saturation : real

이 속성은 소스를 채색하는 데 사용되는 채도 값을 정의합니다.

값의 범위는 0.0(채도가 낮음)에서 1.0(채도가 높음)입니다. 기본적으로 이 속성은 1.0 (채도)로 설정되어 있습니다.

채도 값이 다른 출력 예시

saturation: 0	채도 0.5	채도 1
hue: 0	hue: 0	hue: 0
lightness: 0	lightness: 0	lightness: 0

source : variant

이 속성은 효과의 소스 픽셀을 제공하는 소스 항목을 정의합니다.

참고: 소스를 효과의 부모로 설정하는 등 효과에 효과 자체를 포함하도록 하는 것은 지원되지 않습니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.