Colorize QML Type

HSL 색상 공간의 색상을 설정합니다. 더 보기...

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

속성

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

상세 설명

이 효과는 그레이스케일 이미지 위에 색상이 입혀진 유리를 얹었을 때 나타나는 효과와 유사합니다. Colorize는 색조(hue), 채도(saturation), 명도(lightness, 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

이 속성은 소스 명도 값이 얼마나 증가하거나 감소할지를 정의합니다.

색조(hue) 및 채도(saturation) 속성과 달리, 명도(lightness)는 사용될 값을 직접 설정하는 것이 아니라 기존 소스 픽셀의 명도 값을 변환합니다.

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

saturation : real

이 속성은 소스에 색상을 입힐 때 사용되는 채도 값을 정의합니다.

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

source : variant

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