Qt 5 Compatibility APIs: Graphical Effects
Qt Graphical Effects 모듈은 Qt 5용으로 작성된 애플리케이션과의 호환성을 위해 제공됩니다.
Qt Graphical Effects 모듈은 사용자 인터페이스에 시각적으로 인상적이고 구성 가능한 효과를 추가하기 위한 QML 유형 세트를 제공합니다. 효과는 UI 구성 요소로 Qt Quick 사용자 인터페이스에 추가할 수 있는 시각적 항목입니다.
API는 별도의 QML 유형으로 제공되는 20개 이상의 효과로 구성됩니다. 효과는 마스킹, 블러, 컬러링 등과 같은 기능적 영역을 다룹니다.
시작하기
Qt를 로드하려면 Graphical Effects, .qml 파일에 다음 import 문을 추가합니다:
import Qt5Compat.GraphicalEffects
효과를 사용하려면 QML 씬에 특정 효과 선언을 추가하고 효과 속성을 구성하기만 하면 됩니다. 효과에는 효과가 적용되는 시각적 입력을 지정하기 위한 하나 이상의 소스 프로퍼티가 있습니다. 그러면 변경된 시각적 출력이 효과 항목 자체에 표시됩니다. 소스는 QML 씬에 숨겨져 있는 다른 항목일 수 있습니다. 보다 복잡한 효과는 여러 소스를 가질 수 있습니다. 소스 항목 유형은 비디오나 다른 효과 등 모든 QML 유형이 될 수 있습니다. 여러 효과를 함께 파이프라인으로 연결하면 훨씬 더 인상적인 결과물을 만들 수 있는 간단한 방법입니다.
각 효과에는 효과 출력을 구성하는 데 사용할 수 있는 속성 세트가 있습니다. 프로퍼티는 다른 QML 프로퍼티와 마찬가지로 애니메이션을 적용할 수 있습니다. QML 유형 문서에는 속성 설명과 기본 사용 예제가 포함되어 있습니다.
참고: Qt Quick 의 software
백엔드로 실행할 때는 효과를 사용할 수 없습니다. Qt Quick 씬 그래프 백엔드에 대한 자세한 내용은 씬 그래프 적응을 참조하세요.
참고: GaussianBlur 과 같은 런타임 생성 효과는 셰이더 파일을 QTemporaryFile 을 사용하여 임시 저장소에 저장하므로 쓰기 가능한 파일 시스템이 필요합니다.
QML 유형
블렌드 모드를 사용하여 두 개의 소스 항목을 병합합니다. | |
밝기 및 대비를 조정합니다. | |
오버레이 색상을 적용하여 소스 항목의 색상을 변경합니다. | |
HSL 색 공간에서 색을 설정합니다. | |
원뿔형 그라데이션 그리기 | |
색상의 채도를 낮춥니다. | |
지정된 방향에 흐림 효과 적용 | |
지정된 변위 맵에 따라 소스 항목의 픽셀을 이동합니다. | |
소스 항목 뒤에 부드러운 그림자를 생성합니다. | |
하나 이상의 소스 항목에 빠른 흐림 효과를 적용합니다. | |
소스 항목의 휘도를 변경합니다. | |
더 높은 품질의 흐림 효과 적용 | |
소스의 흐릿하고 컬러화된 이미지를 생성하여 원본 뒤에 배치하여 소스가 빛나고 있는 것처럼 보이게 합니다. | |
HSL 색상 공간에서 소스 항목 색상을 변경합니다. | |
소스 내부에 컬러화되고 흐릿한 그림자를 생성합니다. | |
RGBA 색상 공간에서 색상 레벨을 조정합니다. | |
선형 그라데이션 그리기 | |
다양한 강도의 흐림 효과를 적용합니다. | |
소스 항목을 다른 항목으로 마스크하기 | |
항목 중심점을 중심으로 원형 방향으로 방향 흐림 효과를 적용합니다. | |
방사형 그라데이션 그리기 | |
흐리고 색이 칠해진 직사각형을 생성하여 소스가 빛나는 듯한 인상을 줍니다. | |
반복적으로 흐리게 처리하여 강력한 흐림 효과 제공 | |
소스 항목을 다른 항목으로 마스킹하고 임계값을 적용합니다. | |
소스 항목 중심점을 향해 방향성 흐림 효과 적용 |
참조
© 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.