MaskedBlur QML Type

다양한 강도의 흐림 효과를 적용합니다. 더 보기...

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

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

속성

cached : alias
maskSource : alias
radius : alias
samples : alias
source : alias

상세 설명

마스크드블러 효과는 이미지를 흐리게 처리하여 부드럽게 만듭니다. 블러의 강도는 maskSource 을 사용하여 각 픽셀별로 제어할 수 있으므로 소스의 일부가 다른 부분보다 더 흐릿해집니다.

블러를 실시간으로 수행하는 것은 비용이 많이 드는 작업입니다. 적당한 수의 샘플을 사용한 전체 화면 가우시안 블러는 고급 그래픽 하드웨어에서 60fps로만 실행됩니다.

소스	마스크 소스	효과 적용

참고: 이 효과는 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
    }

    LinearGradient {
        id: mask
        anchors.fill: bug
        gradient: Gradient {
            GradientStop { position: 0.2; color: "#ffffffff" }
            GradientStop { position: 0.5; color: "#00ffffff" }
        }
        start: Qt.point(0, 0)
        end: Qt.point(300, 0)
        visible: false
    }

    MaskedBlur {
        anchors.fill: bug
        source: bug
        maskSource: mask
        radius: 16
        samples: 24
    }
}

속성 문서

cached : alias

이 속성을 사용하면 렌더링 성능을 향상시키기 위해 효과 출력 픽셀을 캐시할 수 있습니다. 소스 또는 효과 속성이 변경될 때마다 캐시에 있는 픽셀을 업데이트해야 합니다. 효과 출력을 저장하는 데 추가 메모리 버퍼가 필요하므로 메모리 사용량이 증가합니다.

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

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

maskSource : alias

이 속성은 블러의 최종 강도를 제어하는 항목을 정의합니다. maskSource의 픽셀 알파 채널 값은 해당 소스 픽셀을 흐리게 하는 데 사용할 실제 흐림 반경을 정의합니다.

불투명 마스크소스 픽셀은 지정된 radius 으로 블러를 생성하고, 투명한 픽셀은 블러를 완전히 억제합니다. 반투명 마스크소스 픽셀은 픽셀 투명도 레벨에 따라 보간된 반경으로 흐림을 생성합니다.

radius : alias

이 속성은 개별 픽셀의 흐림 효과에 영향을 주는 인접 픽셀의 거리를 정의합니다. 반경이 클수록 흐림 효과가 증가합니다.

반경 값에 따라 samples 값을 충분히 크게 설정해야 시각적 품질을 보장할 수 있습니다.

값의 범위는 0.0(흐림 없음)에서 inf까지입니다. 기본적으로 이 속성은 0.0 (흐림 없음)로 설정되어 있습니다.

반경 값이 다른 출력 예시

radius: 0	radius: 8	radius: 16
samples: 25	samples: 25	samples: 25

samples : alias

이 속성은 블러 계산이 수행될 때 픽셀당 얼마나 많은 샘플을 가져올지 정의합니다. 값이 클수록 품질은 좋아지지만 렌더링 속도가 느려집니다.

이 값은 가장 높은 필수 반경 값에 1을 더한 값의 두 배로 설정하는 것이 이상적입니다. 예를 들어 반경이 0.0에서 4.0 사이로 애니메이션되는 경우 샘플은 9로 설정해야 합니다.

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

이 속성은 애니메이션이 적용되지 않습니다. 이 프로퍼티를 변경하면 기본 OpenGL 셰이더가 다시 컴파일될 수 있습니다.

source : alias

이 속성은 흐리게 처리할 소스 항목을 정의합니다.

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

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