ThresholdMask QML Type

소스 항목을 다른 항목으로 가리고 임계값을 적용합니다. 더 보기...

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

속성

• cached : bool
• maskSource : variant
• source : variant
• spread : real
• threshold : real

상세 설명

마스크 픽셀에 대한 ‘ threshold ’ 값을 통해 마스크 동작을 제어할 수 있습니다.

예제

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: background
        anchors.fill: parent
        source: "images/checker.png"
        smooth: true
        fillMode: Image.Tile
    }

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

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

    ThresholdMask {
        anchors.fill: bug
        source: bug
        maskSource: mask
        threshold: 0.4
        spread: 0.2
    }
}

속성 설명서

cached : bool

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

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

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

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

maskSource : variant

이 속성은 마스크로 사용될 항목을 정의합니다. 마스크 항목은 중간 픽셀 버퍼에 렌더링되며, 그 결과의 알파 값을 사용하여 디스플레이에서 소스 항목의 픽셀 표시 여부를 결정합니다.

source : variant

이 속성은 마스킹될 소스 항목을 정의합니다.

spread : real

이 속성은 ‘ threshold ’ 알파 값 근처에서 마스크 가장자리의 부드러움을 정의합니다. 스프레드(spread)를 0.0으로 설정하면 지정된 임계값을 사용하여 마스크가 정상적으로 적용됩니다. 스프레드 값을 더 높게 설정하면 투명한 마스크 픽셀과 불투명한 마스크 픽셀 사이에 보간된 값을 추가하여 두 픽셀 간의 전환을 부드럽게 만듭니다.

값의 범위는 0.0(날카로운 마스크 가장자리)에서 1.0(부드러운 마스크 가장자리)까지입니다. 기본적으로 이 속성은 ‘ 0.0 ’로 설정되어 있습니다.

threshold : real

이 속성은 마스크 픽셀의 임계값을 정의합니다. 이 속성보다 알파 값이 낮은 마스크 픽셀은 소스 항목의 해당 픽셀을 완전히 가리는 데 사용됩니다. 알파 값이 더 높은 마스크 픽셀은 소스 항목을 디스플레이에 알파 블렌딩하는 데 사용됩니다.

값의 범위는 0.0(알파 값 0)에서 1.0(알파 값 255)까지입니다. 기본적으로 이 속성은 0.0 로 설정되어 있습니다.