ZoomBlur QML Type

소스 항목 중심점을 향해 방향 흐림 효과를 적용합니다. 더 보기...

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

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

속성

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

상세 설명

이 효과는 소스 항목이 Z 방향의 중심점을 향해 움직이는 것처럼 보이거나 카메라가 빠르게 줌인하는 것처럼 보이게 하는 효과입니다. 사용 가능한 다른 모션 블러 효과는 DirectionalBlur 및 RadialBlur 입니다.

소스	효과 적용

참고: 이 효과는 OpenGL로 실행할 때 사용할 수 있습니다.

예제

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

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 로 설정되어 있습니다.

수평 오프셋 값이 다른 출력 예시

수평 오프셋: 100.0	수평 오프셋: 0.0	수평 오프셋: -100.0
samples: 24	samples: 24	samples: 24
length: 32	length: 32	length: 32
verticalOffset: 0	verticalOffset: 0	verticalOffset: 0

length : real

이 속성은 각 픽셀에 대해 인식되는 최대 움직임의 양을 정의합니다. 양은 중앙 근처에서 작아지고 가장자리에서 지정된 값에 도달합니다.

블러의 품질은 samples 속성에 따라 달라집니다. 길이 값이 크면 시각적 품질을 높은 수준으로 유지하려면 더 많은 샘플이 필요합니다.

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

길이 값이 다른 출력 예시

length: 0.0	length: 32.0	length: 48.0
samples: 24	samples: 24	samples: 24
horizontalOffset: 0	horizontalOffset: 0	horizontalOffset: 0
verticalOffset: 0	verticalOffset: 0	verticalOffset: 0

samples : int

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

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

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

source : variant

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

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

transparentBorder : bool

이 속성은 항목 가장자리 근처의 흐림 동작을 정의하며, 픽셀 흐림은 소스 가장자리 외부의 픽셀에 의해 영향을 받습니다.

속성이 true 로 설정된 경우 소스 외부의 픽셀은 투명으로 해석되며, 이는 OpenGL 클램프-투-보더 확장과 유사합니다. 흐림 효과는 효과 항목 영역 바깥쪽으로 약간 확장됩니다.

속성이 false 로 설정된 경우 소스 외부의 픽셀은 항목 가장자리에 있는 픽셀과 동일한 색상을 포함하는 것으로 해석되며, 이는 OpenGL 클램프 투 에지 동작과 유사합니다. 흐림 효과는 효과 항목 영역 밖으로 확장되지 않습니다.

기본적으로 이 속성은 false 로 설정됩니다.

verticalOffset : real

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

값 범위는 -inf에서 inf까지입니다. 기본적으로 이러한 속성은 0 로 설정됩니다.

horizontalOffset 값이 다른 출력 예시

horizontalOffset: 100.0	horizontalOffset: 0.0	horizontalOffset: -100.0
samples: 24	samples: 24	samples: 24
length: 32	length: 32	length: 32
수직 오프셋: 0	수직 오프셋: 0	수직 오프셋: 0

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