이 페이지에서

Blend QML Type

블렌드 모드를 사용하여 두 소스 항목을 병합합니다. 더 보기...

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

Item

속성

상세 설명

mode 속성을 사용하여 블렌드 모드를 선택할 수 있습니다.

출처foregroundSource효과 적용

잎 위에 있는 검은 딱정벌레

알록달록한 나비 그래픽

딱정벌레와 나비가 하나로 어우러진 모습

참고: 이 효과는 OpenGL로 실행할 때 사용할 수 있습니다.

예제

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

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
    }

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

    Blend {
        anchors.fill: bug
        source: bug
        foregroundSource: butterfly
        mode: "subtract"
    }
}

속성 설명서

cached : bool

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

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

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

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

foregroundSource : variant

이 속성은 ‘ source ’ 위에 블렌딩될 항목을 정의합니다.

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

mode : string

이 속성은 ‘ foregroundSource ’가 소스 위에 블렌딩될 때 사용되는 모드를 정의합니다. 값은 대소문자를 구분하지 않습니다.

mode설명
normalforegroundSource 의 픽셀 구성 요소 값이 알파 블렌딩을 사용하여 소스 위에 쓰입니다.
addition소스 및 foregroundSource 의 픽셀 구성 요소 값이 더해진 후 출력됩니다.
평균소스 및 foregroundSource 의 픽셀 구성 요소 값을 평균 내어 출력합니다.
색상소스(source)의 명도 값에 소스( foregroundSource )의 색상(hue) 및 채도(saturation) 값을 결합하여 출력합니다.
colorBurn소스(source)의 어두운 픽셀은 더 어두워지고, 소스와 foregroundSource 의 픽셀이 모두 밝을 경우 결과도 밝아집니다.
colorDodge소스의 밝은 픽셀은 더 밝아지고, 소스와 foregroundSource 의 픽셀이 모두 어두운 경우 결과도 어두워집니다.
darken소스 및 foregroundSource 중 더 어두운 픽셀 구성 요소 값이 기록됩니다.
darkerColor소스 및 foregroundSource 중 휘도가 더 낮은 픽셀의 RGB 값이 기록됩니다.
difference소스(source)와 foregroundSource 간의 픽셀 구성 요소 값의 절대 차이가 기록됩니다.
divide소스의 픽셀 구성 요소 값을 foregroundSource 의 값으로 나눈 값이 기록됩니다.
제외소스와 foregroundSource 간의 픽셀 성분 값 차이에서 대비를 낮춘 값이 기록됩니다.
hardLight소스의 픽셀 구성 요소 값이 foregroundSource 의 값에 따라 밝아지거나 어두워진 후 출력됩니다.
hueforegroundSource 의 색상 값이 소스의 채도 및 명도와 결합되어 기록됩니다.
lighten소스 및 foregroundSource 중 가장 밝은 픽셀 구성 요소 값이 기록됩니다.
lighterColor소스 및 foregroundSource 중 휘도가 더 높은 픽셀의 RGB 값이 기록됩니다.
lightnessforegroundSource 의 명도 값이 소스(source)의 색상(hue) 및 채도(saturation)와 결합되어 기록됩니다.
곱하기소스 및 foregroundSource 의 픽셀 구성 요소 값을 서로 곱한 후 기록합니다.
부정소스(source)와 foregroundSource 간의 절대 픽셀 구성 요소 값 차이의 반전된 값이 기록됩니다.
채도foregroundSource 의 채도 값을 소스(source)의 색상(hue) 및 명도(lightness)와 결합하여 출력합니다.
스크린소스(source)와 대상( foregroundSource )의 픽셀 값을 부호 반전시킨 후 곱하고, 다시 부호 반전시킨 다음 출력합니다.
subtractforegroundSource 의 픽셀 값을 소스의 값에서 뺀 후, 그 결과를 출력합니다.
softLight소스(source)의 픽셀 구성 요소 값이 반사( foregroundSource ) 값에 따라 약간 밝아지거나 어두워진 후 화면에 출력됩니다.
소스 예시예시 foregroundSource

잎 위에 있는 검은 딱정벌레

알록달록한 나비 그래픽

모드 값이 다른 출력 예시

노멀 모드에서 블렌드 효과 적용

블렌드 효과와 더하기 모드

평균 모드를 사용한 블렌드 효과

mode: normal mode: addition mode: average

색상 모드를 사용한 블렌드 효과

Blend 효과와 ColorBurn 모드를 함께 사용하기

컬러 도지 모드를 사용하여 블렌드 효과 적용하기

모드: color 모드: colorBurn 모드: 색상 도지

어두게 만들기 모드를 사용한 블렌드 효과

‘더 어두운 색상’ 모드를 사용한 블렌드 효과

차이 모드를 사용한 블렌드 효과

모드: 어둡게 모드: 더어커컬러 모드: 차이

블렌드 효과와 나눗셈 모드

제외 모드를 적용한 블렌드 효과

하드라이트 모드를 사용한 블렌드 효과

모드: divide 모드: exclusion 모드: 하드라이트

색조 모드를 사용한 블렌드 효과

블렌드 효과와 밝게 모드를 함께 적용하기

‘blend’ 효과와 ‘lighterColor’ 모드 조합

모드: 색조 모드: 밝게 만들기 모드: 더 밝은 색상

블렌드 효과와 명도 모드

부정 모드를 적용한 블렌드 효과

블렌드 효과와 곱하기 모드

모드: 명도 모드: 부정 모드: 곱하기

채도 모드를 사용한 블렌드 효과

블렌드 효과와 스크린 모드

차감 모드를 사용한 블렌드 효과

모드: 채도 모드: 스크린 모드: 빼기

소프트라이트 모드를 사용한 블렌드 효과

모드: 소프트라이트

source : variant

이 속성은 ‘ foregroundSource ’ 효과가 적용될 때 기준이 되는 소스 항목을 정의합니다.

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

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