이 페이지에서

LevelAdjust QML Type

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

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

Item

속성

상세 설명

이 효과는 소스 항목의 색상을 각 색상 채널별로 개별적으로 조정합니다. 소스 항목의 명암비를 조절하고 색 균형을 변경할 수 있습니다.

소스효과 적용 후

알록달록한 나비 그래픽

수평 보정이 적용된 나비

예시

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

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) (변경 없음)로 설정되어 있습니다.

다양한 감마 값을 적용한 출력 예시

기본 감마 값을 적용한 나비

RGB 감마 값이 조정된 나비

감마 값을 극단적으로 조정한 나비

gamma: Qt.vector3d(1.0, 1.0, 1.0) gamma: Qt.vector3d(1.0, 0.4, 2.0) gamma: Qt.vector3d(1.0, 0.1, 4.0)
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #ffffff
위 이미지의 픽셀 색상 채널 휘도 곡선.

기본 휘도 곡선

수정된 감마 휘도 곡선

극한 감마 휘도 곡선

X축: 픽셀의 원래 휘도
Y축: 효과가 적용된 색상 채널 휘도

maximumInput : color

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

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

다양한 maximumInput 값을 적용한 출력 예시

입력 조정 상한 없음

중간 최대 입력 임계값

낮은 최대 입력 임계값

maximumInput: #FFFFFFFF maximumInput: #FFFFFF80 maximumInput: #FFFFFF30
minimumInput: #000000minimumInput: #000000minimumInput: #000000
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #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 값을 적용한 출력 예시

최대 출력 조정 불가

중간 최대 출력 레벨

최대 출력 레벨이 낮음

maximumOutput: #FFFFFFFF maximumOutput: #FFFFFF80 maximumOutput: #FFFFFF30
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #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 값을 적용한 출력 예시

최소 입력 조정 없음

낮은 최소 입력 기준

높은 최소 입력 임계값

minimumInput: #00000000 minimumInput: #00000040 minimumInput: #00000070
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #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 값을 적용한 출력 예시

최소 출력 조정 없음

중간 최소 출력 레벨

높은 최소 출력 레벨

minimumOutput: #00000000 minimumOutput: #00000070 minimumOutput: #000000A0
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #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

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

참고: 예를 들어 소스를 효과의 상위 항목으로 설정하는 등, 효과가 스스로를 포함하도록 하는것은 지원되지않습니다 .

© 2026 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.