QGraphicsBlurEffect Class
QGraphicsBlurEffect 클래스는 블러 효과를 제공합니다. 더 보기...
| 헤더: | #include <QGraphicsBlurEffect> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QGraphicsEffect |
공개 유형
속성
- blurHints : BlurHints
- blurRadius : qreal
공개 함수
| QGraphicsBlurEffect(QObject *parent = nullptr) | |
| virtual | ~QGraphicsBlurEffect() |
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| qreal | blurRadius() const |
재구현된 공용 함수
| virtual QRectF | boundingRectFor(const QRectF &rect) const override |
공개 슬롯
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
| void | setBlurRadius(qreal blurRadius) |
신호
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
| void | blurRadiusChanged(qreal radius) |
재구현된 보호 함수
| virtual void | draw(QPainter *painter) override |
상세 설명
블러 효과는 소스 이미지를 흐리게 만듭니다. 이 효과는 소스 이미지가 초점에서 벗어났을 때 다른 요소에 시선을 집중시키고자 할 때와 같이 세부 사항을 줄이는 데 유용합니다. 세부 사항의 수준은 ` setBlurRadius()` 함수를 사용하여 조정할 수 있습니다. ` setBlurHints()`를 사용하여 블러 힌트를 선택하십시오.
기본적으로 블러 반경은 5픽셀입니다. 블러 반경은 장치 좌표계로 지정됩니다.
QGraphicsDropShadowEffect, QGraphicsColorizeEffect 및 QGraphicsOpacityEffect도 참조하십시오 .
멤버 유형 설명서
enum QGraphicsBlurEffect::BlurHint
flags QGraphicsBlurEffect::BlurHints
이 열거형은 블러 효과가 적용되는 방식을 제어하는 데 사용할 수 있는 가능한 힌트를 설명합니다. 이러한 힌트는 모든 페인트 엔진에서 효과가 나타나지 않을 수도 있습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGraphicsBlurEffect::PerformanceHint | 0x00 | 렌더링 성능이 가장 중요한 요소임을 나타내며, 이로 인해 화질이 저하될 수 있습니다. |
QGraphicsBlurEffect::QualityHint | 0x01 | 렌더링 품질이 가장 중요한 요소임을 나타내며, 이로 인해 성능이 저하될 수 있습니다. |
QGraphicsBlurEffect::AnimationHint | 0x02 | 블러 반경이 애니메이션 처리될 것임을 나타내며, 구현에서 소스 이미지의 블러 처리된 버전을 캐시에 보관할 수 있음을 암시합니다. 소스 이미지가 동적으로 변경될 경우 이 힌트를 사용하지 마십시오. |
BlurHints 유형은 QFlags<BlurHint>에 대한 typedef입니다. 이 유형은 BlurHint 값들의 OR 조합을 저장합니다.
blurHints() 및 setBlurHints()도 참조하십시오 .
속성 설명서
blurHints : BlurHints
이 속성은 효과의 블러 힌트를 저장합니다.
PerformanceHint 힌트를 사용하여 더 빠른 블러 효과를 지정하고, QualityHint 힌트를 사용하여 더 높은 품질의 블러를 지정하거나, AnimationHint 를 사용하여 블러 반경을 애니메이션으로 표현할 수 있습니다.
기본적으로 블러 힌트는 PerformanceHint 입니다.
액세스 함수:
| QGraphicsBlurEffect::BlurHints | blurHints() const |
| void | setBlurHints(QGraphicsBlurEffect::BlurHints hints) |
알림 신호:
| void | blurHintsChanged(QGraphicsBlurEffect::BlurHints hints) |
blurRadius : qreal
이 속성은 효과의 블러 반경을 지정합니다.
반지름을 작게 설정하면 더 선명한 모양이 되고, 반지름을 크게 설정하면 더 흐릿한 모양이 됩니다.
기본적으로 블러 반경은 5픽셀입니다.
반경은 장치 좌표로 지정되므로 스케일의 영향을 받지 않습니다.
액세스 함수:
| qreal | blurRadius() const |
| void | setBlurRadius(qreal blurRadius) |
알림 신호:
| void | blurRadiusChanged(qreal radius) |
멤버 함수 문서
QGraphicsBlurEffect::QGraphicsBlurEffect(QObject *parent = nullptr)
새로운 QGraphicsBlurEffect 인스턴스를 생성합니다. ` parent ` 매개변수는 ` QGraphicsEffect`의 생성자에 전달됩니다.
[virtual noexcept] QGraphicsBlurEffect::~QGraphicsBlurEffect()
효과를 해제합니다.
[signal] void QGraphicsBlurEffect::blurHintsChanged(QGraphicsBlurEffect::BlurHints hints)
이 신호는 이펙트의 블러 힌트가 변경될 때마다 발생합니다. ` hints ` 매개변수에는 이펙트의 새로운 블러 힌트가 저장됩니다.
참고: 속성 ` blurHints`에 대한알림 신호입니다.
[signal] void QGraphicsBlurEffect::blurRadiusChanged(qreal radius)
이 신호는 이펙트의 블러 반경이 변경될 때마다 발생합니다. ` radius ` 매개변수에는 이펙트의 새로운 블러 반경이 저장됩니다.
참고: 속성 ` blurRadius`에 대한알림 신호입니다.
[override virtual] QRectF QGraphicsBlurEffect::boundingRectFor(const QRectF &rect) const
QGraphicsEffect::boundingRectFor(const QRectF &rect) const를 재구현합니다.
[override virtual protected] void QGraphicsBlurEffect::draw(QPainter *painter)
QGraphicsEffect::draw(QPainter *painter)를 재구현합니다.
© 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.
