RecursiveBlur QML Type

반복적으로 흐리게 처리하여 강렬한 흐림 효과를 제공합니다. 더 보기...

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

속성

• cached : bool
• loops : int
• progress : real
• radius : real
• source : variant
• transparentBorder : bool

상세 설명

RecursiveBlur 효과는 재귀적 피드백 루프를 사용하여 원본 이미지를 여러 번 흐리게 처리하는 알고리즘을 통해 이미지를 부드럽게 만듭니다. 이 효과는 GaussianBlur 또는 FastBlur 에서 제공하는 효과보다 더 흐릿한 결과를 나타낼 수 있지만, 결과가 비동기적으로 생성되므로 처리 시간이 더 오래 걸립니다.

예제

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

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
    }

    RecursiveBlur {
        anchors.fill: bug
        source: bug
        radius: 7.5
        loops: 50
    }
}

속성 설명

cached : bool

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

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

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

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

loops : int

이 속성은 소스 이미지에 대해 수행될 블러 반복 횟수를 정의합니다. 속성이 변경되면 반복적인 블러 처리 과정이 시작됩니다. 값이 감소하거나 0에서 0이 아닌 값으로 변경되면 소스 이미지의 스냅샷이 촬영됩니다. 이 스냅샷은 처리 과정의 시작점으로 사용됩니다.

반복 루프는 가능한 한 빠르게 실행되도록 시도합니다. 속도는 VSYNC 또는 한 번의 블러 단계에 소요되는 시간, 혹은 두 가지 모두에 의해 제한될 수 있습니다. 때로는 블러 처리를 더 느린 속도로 수행하는 것이 바람직할 수 있습니다. 이 경우, 값을 증가시키는 Animation을 사용하여 이 속성을 제어하는 것이 편리할 수 있습니다.

값의 범위는 0에서 무한대(inf)까지입니다. 기본적으로 이 속성은 ` 0`로 설정되어 있습니다.

progress : real

이 속성은 비동기 소스 블러링 처리의 진행 상황을 0.0(블러링되지 않음)부터 1.0(완료됨)까지 나타냅니다.

radius : real

이 속성은 개별 픽셀의 흐림 효과에 영향을 미치는 인접 픽셀 간의 거리를 정의합니다. 반지름이 클수록 화질은 좋아지지만, 렌더링 속도는 느려집니다.

참고: 이 효과에서 반경 값은 자주 변경하거나 애니메이션을 적용하도록 의도된 것이 아닙니다. 올바른 사용 방법은 적절한 값을 설정한 후, 반복적인 블러 처리 시퀀스가 진행되는 동안 해당 값을 변경하지 않고 유지하는 것입니다.

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

source : variant

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

transparentBorder : bool

이 속성은 항목의 가장자리 부근에서 발생하는 블러 동작을 정의하며, 이 경우 소스 가장자리 바깥쪽의 픽셀이 픽셀 블러링에 영향을 미칩니다.

이 속성이 ` true`로 설정되면, 소스 영역 외부의 픽셀은 투명한 것으로 해석되며, 이는 OpenGL의 `clamp-to-border` 확장 기능과 유사합니다. 블러 효과는 효과 적용 대상 항목 영역 밖으로 약간 확장됩니다.

이 속성이 ` false`로 설정되면, 소스 외부의 픽셀은 항목 가장자리의 픽셀과 동일한 색상을 포함하는 것으로 해석되며, 이는 OpenGL의 `clamp-to-edge` 동작과 유사합니다. 블러는 효과 항목 영역 밖으로 확장되지 않습니다.

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