이 페이지에서

OpacityMask QML Type

소스 항목을 다른 항목으로 가립니다. 더 보기...

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

Item

속성

상세 설명

참고: ` MultiEffect `컴포넌트는 성능 면에서 몇 가지 이점을 제공하는 마스크 효과를 제공합니다. 새로운 코드를 작성할 때는 Qt의 ` Graphical Effects`을 사용하는 대신 이 컴포넌트를 대안으로 고려해 보시기 바랍니다.

소스MaskSource적용된 효과

잎 위에 있는 검은 딱정벌레

원형 그라데이션 마스크

원형 마스크가 적용된 비틀

예제

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

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: mask
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    OpacityMask {
        anchors.fill: bug
        source: bug
        maskSource: mask
    }
}

속성 설명서

cached : bool

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

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

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

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

참고: 예를 들어, maskSource 를 효과의 부모로 설정하여 효과가 스스로를 포함하도록 하는것은 지원되지 않습니다.

invert : bool

이 속성은 sourceMask의 알파 값이 어떻게 처리될지 결정합니다.

이 속성이 ` false`인 경우, 결과 불투명도는 소스 알파 값에 마스크 알파 값을 곱한 값이 됩니다( As * Am).

이 속성이 ` true`인 경우, 결과 불투명도는 소스 알파에 마스크 알파의 역수를 곱한 값이 됩니다( As * (1 - Am)).

기본값은 false 입니다.

maskSource : variant

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

원본마스크효과 적용 후

잎 위에 있는 검은 딱정벌레

원형 그라데이션 마스크

원형 마스크가 적용된 비틀

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.