이 페이지에서

FastBlur QML Type

하나 이상의 소스 항목에 빠른 블러 효과를 적용합니다. 더 보기...

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

Item

속성

상세 설명

참고: ` MultiEffect `컴포넌트는 성능상의 이점을 제공하는 블러 효과를 제공합니다. 새로운 코드를 작성할 때는 Qt XML의 ` Graphical Effects`을 사용하는 대신 이 컴포넌트를 대안으로 고려해야 합니다.

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
    }

    FastBlur {
        anchors.fill: bug
        source: bug
        radius: 32
    }
}

속성 설명

cached : bool

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

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

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

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

radius : real

이 속성은 개별 픽셀의 블러링에 영향을 미치는 인접 픽셀 간의 거리를 정의합니다. 반지름이 클수록 블러 효과가 커집니다. FastBlur 알고리즘은 원활한 렌더링 성능을 제공하기 위해 내부적으로 반지름의 정확도를 낮출 수 있습니다.

값의 범위는 0.0(블러 없음)부터 inf까지입니다. 반지름이 64를 초과하면 블러의 시각적 품질이 저하됩니다. 기본적으로 이 속성은 0.0 (블러 없음)로 설정되어 있습니다.

다양한 블러 값을 적용한 출력 예시

흐림 현상이 없는 비틀

적당히 흐릿한 딱정벌레

최대 흐림 효과가 적용된 딱정벌레

반경: 0 반경: 32 반경: 64

source : variant

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

참고: 예를 들어 소스를 이 효과의 상위 요소로 설정하는 등, 효과가 스스로를 포함하도록 하는것은 지원되지않습니다 .

transparentBorder : bool

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

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

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

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

transparentBorder 값이 다른 출력 예시

가장자리 고정 기능을 적용한 블러

가장자리가 투명한 흐림 효과

transparentBorder: false transparentBorder: true
radius: 64radius: 64

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