LevelAdjust QML Type

RGBA 색 공간에서 색상 레벨을 조정합니다. 더 보기...

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

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

속성

cached : bool
gamma : variant
maximumInput : color
maximumOutput : color
minimumInput : color
minimumOutput : color
source : variant

상세 설명

이 효과는 각 색상 채널에 대해 소스 항목 색상을 개별적으로 조정합니다. 소스 항목 대비를 조정하고 색상 밸런스를 변경할 수 있습니다.

소스	적용된 효과

예제

다음 예는 효과를 적용하는 방법을 보여줍니다.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: butterfly
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    LevelAdjust {
        anchors.fill: butterfly
        source: butterfly
        minimumOutput: "#00ffffff"
        maximumOutput: "#ff000000"
    }
}

속성 문서

cached : bool

이 속성을 사용하면 렌더링 성능을 향상시키기 위해 효과 출력 픽셀을 캐시할 수 있습니다.

소스 또는 효과 속성이 변경될 때마다 캐시에 있는 픽셀을 업데이트해야 합니다. 효과 출력을 저장하는 데 추가 메모리 버퍼가 필요하므로 메모리 사용량이 증가합니다.

소스 또는 효과 속성에 애니메이션이 적용될 때는 캐시를 비활성화하는 것이 좋습니다.

기본적으로 이 속성은 false 로 설정되어 있습니다.

gamma : variant

이 속성은 각 픽셀 색상 채널의 값이 방정식에 따라 변경되는 방식에 대한 변경 계수를 정의합니다:

result.rgb = pow(original.rgb, 1.0 / gamma.rgb);

감마 값을 QtVector3d(1.0, 1.0, 1.0) 미만으로 설정하면 이미지가 어두워지고, QtVector3d(1.0, 1.0, 1.0) 이상이면 이미지가 밝아집니다.

값의 범위는 QtVector3d(0.0, 0.0, 0.0)(가장 어둡게)에서 inf(가장 밝게)까지입니다. 기본적으로 이 속성은 QtVector3d(1.0, 1.0, 1.0) (변경 없음)로 설정되어 있습니다.

감마 값이 다른 출력 예제

gamma: Qt.vector3d(1.0, 1.0, 1.0)	감마: Qt.vector3d(1.0, 0.4, 2.0)	감마: Qt.vector3d(1.0, 0.1, 4.0)
minimumInput: #000000	minimumInput: #000000	minimumInput: #000000
maximumInput: #ffffff	maximumInput: #ffffff	maximumInput: #ffffff
minimumOutput: #000000	minimumOutput: #000000	minimumOutput: #000000
maximumOutput: #ffffff	maximumOutput: #ffffff	maximumOutput: #ffffff

위 이미지의 픽셀 컬러 채널 휘도 곡선입니다.

X축: 픽셀 원본 휘도
Y축: 효과가 적용된 컬러 채널 휘도

maximumInput : color

이 속성은 각 색상 채널의 최대 입력 레벨을 정의합니다. 화이트 포인트를 설정하며, 이 속성보다 높은 값을 가진 모든 픽셀은 (색상 채널별로) 흰색으로 렌더링됩니다. 값을 낮추면 밝은 영역이 밝아집니다.

값의 범위는 "#ffffffff"에서 "#00000000"까지입니다. 기본적으로 이 속성은 "#ffffffff" (변경 없음)로 설정되어 있습니다.

최대 입력 값이 다른 출력 예제

maximumInput: #ffffffff	maximumInput: #FFFFFF80	maximumInput: #FFFFFF30
minimumInput: #000000	minimumInput: #000000	minimumInput: #000000
minimumOutput: #000000	minimumOutput: #000000	minimumOutput: #000000
maximumOutput: #ffffff	maximumOutput: #ffffff	maximumOutput: #ffffff
gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)

위 이미지의 픽셀 컬러 채널 휘도 곡선입니다.

X축: 픽셀 원본 휘도
Y축: 효과가 적용된 컬러 채널 휘도

maximumOutput : color

이 속성은 각 색상 채널의 최대 출력 레벨을 정의합니다. 값을 낮추면 밝은 영역이 어두워져 대비가 감소합니다.

값의 범위는 "#ffffffff"에서 "#00000000"까지입니다. 기본적으로 이 속성은 "#ffffffff" (변경 없음)로 설정되어 있습니다.

최대출력 값이 다른 출력 예시

maximumOutput: #ffffffff	maximumOutput: #FFFFFF80	maximumOutput: #FFFFFF30
minimumInput: #000000	minimumInput: #000000	minimumInput: #000000
maximumInput: #ffffff	maximumInput: #ffffff	maximumInput: #ffffff
minimumOutput: #000000	minimumOutput: #000000	minimumOutput: #000000
gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)

위 이미지의 픽셀 컬러 채널 휘도 곡선입니다.

X축: 픽셀 원본 휘도
Y축: 효과가 적용된 컬러 채널 휘도

minimumInput : color

이 속성은 각 색상 채널의 최소 입력 레벨을 정의합니다. 블랙 포인트를 설정하며, 이 속성보다 낮은 값을 가진 모든 픽셀은 (컬러 채널별로) 검은색으로 렌더링됩니다. 값을 높이면 어두운 영역이 어두워집니다.

값의 범위는 "#00000000"에서 "#ffffffff"입니다. 기본적으로 이 속성은 "#00000000" (변경 없음)로 설정되어 있습니다.

최소 입력 값이 다른 출력 예시

minimumInput: #00000000	minimumInput: #00000040	minimumInput: #00000070
maximumInput: #ffffff	maximumInput: #ffffff	maximumInput: #ffffff
minimumOutput: #000000	minimumOutput: #000000	minimumOutput: #000000
maximumOutput: #ffffff	maximumOutput: #ffffff	maximumOutput: #ffffff
gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)

위 이미지의 픽셀 컬러 채널 휘도 곡선입니다.

X축: 픽셀 원본 휘도
Y축: 효과가 적용된 컬러 채널 휘도

minimumOutput : color

이 속성은 각 색상 채널의 최소 출력 레벨을 정의합니다. 값을 높이면 어두운 영역이 밝아지고 대비가 감소합니다.

값의 범위는 "#00000000"에서 "#ffffffff"까지입니다. 기본적으로 이 속성은 "#00000000" (변경 없음)로 설정되어 있습니다.

최소 출력 값이 다른 출력 예시

minimumOutput: #00000000	minimumOutput: #00000070	minimumOutput: #000000A0
minimumInput: #000000	minimumInput: #000000	minimumInput: #000000
maximumInput: #ffffff	maximumInput: #ffffff	maximumInput: #ffffff
maximumOutput: #ffffff	maximumOutput: #ffffff	maximumOutput: #ffffff
gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)	gamma: Qt.vector3d(1.0, 1.0, 1.0)

위 이미지의 픽셀 컬러 채널 휘도 곡선입니다.

X축: 픽셀 원본 휘도
Y축: 효과가 적용된 컬러 채널 휘도

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.