Blend QML Type

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

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

Item

속성

상세 설명

블렌드 모드는 mode 속성으로 선택할 수 있습니다.

sourceforegroundSource적용된 효과

참고: 이 효과는 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 에 블렌딩할 항목을 정의합니다.

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


mode : string

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

mode설명
normalforegroundSource 의 픽셀 컴포넌트 값이 알파 블렌딩을 사용하여 소스 위에 기록됩니다.
addition소스 및 foregroundSource 의 픽셀 컴포넌트 값을 합산하여 기록합니다.
평균소스 및 foregroundSource 의 픽셀 컴포넌트 값을 평균하여 기록합니다.
color소스의 밝기 값을 foregroundSource 의 색조 및 채도와 결합하여 기록합니다.
colorBurn소스의 어두운 픽셀이 더 어둡게 처리되며, 소스 및 foregroundSource 픽셀이 모두 밝은 경우 결과는 밝게 처리됩니다.
colorDodge소스에서 밝은 픽셀이 더 밝아지며, 소스 및 foregroundSource 픽셀이 모두 어두운 경우 결과는 어둡습니다.
어둡게소스 및 foregroundSource 의 더 어두운 픽셀 컴포넌트 값이 기록됩니다.
darkerColor소스 및 foregroundSource 에서 더 낮은 휘도 픽셀 RGB 값이 기록됩니다.
차이소스와 foregroundSource 사이의 절대 픽셀 컴포넌트 값 차이가 기록됩니다.
divide소스의 픽셀 컴포넌트 값을 foregroundSource 의 값으로 나누어 기록합니다.
제외소스와 foregroundSource 사이의 대비가 감소된 픽셀 컴포넌트 값 차이를 기록합니다.
hardLight소스의 픽셀 컴포넌트 값을 foregroundSource 값에 따라 밝게 또는 어둡게 하여 기록합니다.
hueforegroundSource 의 색조 값을 소스의 채도 및 명도와 결합하여 기록합니다.
밝게소스에서 가장 밝은 픽셀 컴포넌트 값과 foregroundSource 값이 기록됩니다.
lighterColor소스 및 foregroundSource 의 더 높은 휘도 픽셀 RGB 값이 기록됩니다.
밝기foregroundSource 의 밝기 값이 소스의 색조 및 채도와 결합되어 기록됩니다.
곱하기소스 및 foregroundSource 의 픽셀 컴포넌트 값을 함께 곱하여 기록합니다.
부정소스와 foregroundSource 사이의 반전된 절대 픽셀 컴포넌트 값 차이가 기록됩니다.
채도foregroundSource 의 채도 값이 소스의 색조 및 명도와 결합되어 기록됩니다.
화면소스 및 foregroundSource 의 픽셀 값을 음수화한 다음 곱하고 다시 음수화한 후 기록합니다.
빼기foregroundSource 의 픽셀 값을 소스에서 빼서 기록합니다.
softLight소스의 픽셀 컴포넌트 값을 foregroundSource 값에 따라 약간 밝게 또는 어둡게 하여 기록합니다.
소스 예시예제 foregroundSource

모드 값이 다른 출력 예시

모드: 일반 모드: 더하기 모드: 평균

mode: color mode: colorBurn 모드: colorDodge

모드: 어둡게 mode: darkerColor mode: difference

mode: divide 모드: 제외 모드: 하드라이트

모드: 색조 모드: 밝게 모드: 밝게

모드: 밝기 모드: 부정 모드: 곱하기

모드: 채도 모드: 화면 모드: 빼기

모드: 소프트라이트

source : variant

이 속성은 foregroundSource 위에 블렌딩할 때 기준이 될 소스 항목을 정의합니다.

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


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