MaskedBlur QML Type

강도가 변화하는 블러 효과를 적용합니다. 더 보기...

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

속성

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

자세한 설명

MaskedBlur 효과는 이미지를 흐리게 처리하여 부드럽게 만듭니다. maskSource 를 사용하여 픽셀별로 흐림 강도를 조절할 수 있으므로, 원본 이미지의 특정 부분을 다른 부분보다 더 강하게 흐리게 처리할 수 있습니다.

실시간으로 블러 처리를 수행하는 것은 높은 성능을 요구하는 작업입니다. 샘플 수가 적당히 많은 풀스크린 가우시안 블러의 경우, 고성능 그래픽 하드웨어에서도 60fps로만 실행됩니다.

예제

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

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의 픽셀 알파 채널 값은 해당 소스 픽셀을 블러 처리하는 데 사용될 실제 블러 반경을 정의합니다.

불투명한 maskSource 픽셀은 지정된 radius 만큼 흐림 효과를 생성하는 반면, 투명한 픽셀은 흐림 효과를 완전히 억제합니다. 반투명한 maskSource 픽셀은 픽셀의 투명도 수준에 따라 보간된 반경으로 흐림 효과를 생성합니다.

radius : alias

이 속성은 개별 픽셀의 흐림 효과에 영향을 미치는 인접 픽셀 간의 거리를 정의합니다. 반지름이 클수록 흐림 효과가 더 강해집니다.

반경 값에 따라, 시각적 품질을 보장하기 위해 ‘ samples ’ 값을 충분히 크게 설정해야 합니다.

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

samples : alias

이 속성은 블러 계산 시 픽셀당 몇 개의 샘플을 채취할지 정의합니다. 값이 클수록 품질은 좋아지지만, 렌더링 속도는 느려집니다.

이상적으로는 이 값을 필요한 최대 반지름 값에 1을 더한 값의 두 배로 설정해야 합니다. 예를 들어, 반지름이 0.0에서 4.0 사이로 애니메이션되는 경우, 샘플 수는 9로 설정해야 합니다.

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

이 속성은 애니메이션을 위해 설계된 것이 아닙니다. 이 속성을 변경하면 기본 OpenGL 셰이더가 재컴파일될 수 있습니다.

source : alias

이 속성은 흐림 처리가 적용될 소스 항목을 정의합니다.