ZoomBlur QML Type

소스 항목의 중심점을 향해 방향성 블러 효과를 적용합니다. 더 보기...

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

속성

• cached : bool
• horizontalOffset : real
• length : real
• samples : int
• source : variant
• transparentBorder : bool
• verticalOffset : real

상세 설명

이 효과는 소스 객체가 Z축 방향으로 중심점을 향해 움직이는 것처럼 보이게 하거나, 카메라가 빠르게 줌인하는 것처럼 보이게 하는 시각적 인상을 줍니다. 사용 가능한 다른 모션 블러 효과로는 DirectionalBlur 및 RadialBlur 등이 있습니다.

예

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    ZoomBlur {
        anchors.fill: butterfly
        source: butterfly
        samples: 24
        length: 48
    }
}

속성 설명

cached : bool

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

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

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

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

horizontalOffset : real

이 속성들은 블러 방향의 중심점에 대한 픽셀 단위의 오프셋을 정의합니다.

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

length : real

이 속성은 각 픽셀에 대해 감지되는 움직임의 최대량을 정의합니다. 이 값은 중심에 가까울수록 작아지며, 가장자리에서 지정된 값에 도달합니다.

블러의 품질은 ` samples ` 속성에 따라 달라집니다. `length` 값이 클수록 높은 수준의 시각적 품질을 유지하기 위해 더 많은 샘플이 필요합니다.

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

samples : int

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

이 속성은 애니메이션용으로 설계되지 않았습니다. 이 속성을 변경하면 기본 OpenGL 셰이더가 재컴파일될 수 있습니다.

허용되는 값은 0에서 inf 사이입니다(실질적인 최대값은 GPU에 따라 다름). 기본적으로 이 속성은 0 (샘플 없음)으로 설정되어 있습니다.

source : variant

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

transparentBorder : bool

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

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

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

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

verticalOffset : real

이 속성들은 블러 방향의 중심점에 대한 픽셀 단위의 오프셋을 정의합니다.

값의 범위는 -inf부터 inf까지입니다. 기본적으로 이 속성들은 ` 0`로 설정되어 있습니다.