Qt Quick 3D
Qt Quick 3D 는 다음을 기반으로 한 3D 콘텐츠 및 3D 사용자 인터페이스를 생성하기 위한 고수준 API를 제공합니다 Qt Quick. 동기화 문제와 추가적인 추상화 계층을 유발하는 외부 엔진을 사용하는 대신, Qt Quick 3D 는 공간 콘텐츠를 위해 기존 Qt Quick 시나리오 그래프에 대한 확장 기능과 해당 확장된 시나리오 그래프를 위한 렌더러를 제공합니다. 공간 시나리오 그래프를 사용할 경우, Qt Quick 2D 콘텐츠와 3D 콘텐츠를 혼합하여 사용할 수 있습니다.
Qt Quick 3D 또한 Qt Quick 3D Xr을 통해 XR 및 VR 애플리케이션도 지원합니다.

모듈 사용법
QML API
이 모듈의 QML 타입은 QtQuick3D 임포트를 통해 사용할 수 있습니다. 해당 타입을 사용하려면 .qml 파일에 다음 임포트 문장을 추가하십시오:
import QtQuick3D다음 모듈 임포트는 추가 기능을 제공합니다:
import QtQuick3D.AssetUtils
import QtQuick3D.Helpers
import QtQuick3D.Particles3D
import QtQuick3D.XrC++ API
Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리를 직접 또는 다른 종속성을 통해 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 위해 전용 지원을 제공합니다.
CMake를 사용한 빌드
` find_package() ` 명령을 사용하여 ` Qt6 ` 패키지 내에서 필요한 모듈 구성 요소를 찾으십시오:
find_package(Qt6 REQUIRED COMPONENTS Quick3D)
target_link_libraries(mytarget PRIVATE Qt6::Quick3D)자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.
qmake를 사용한 빌드
qmake를 사용하여 모듈을 빌드하도록 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 해당 모듈을 추가하십시오:
QT += quick3d소스 코드 빌드
소스 코드에서 빌드할 때는 qtdeclarative 및 qtshadertools 저장소의 모듈과 도구를 먼저 빌드해야 합니다. 이 요소들이 없으면 Qt Quick 3D 를 사용할 수 없기 때문입니다. 또한 키프레임 기반 애니메이션을 사용하려면 qtquicktimeline이 반드시 필요하므로, 이를 사용할 수 있도록 하는 것이 강력히 권장됩니다.
또한, 일부 예제에서는 Qt Quick Controls.
모듈의 발전
Qt Quick 3D 의 변경 사항에는 Qt 6 시리즈를 위해 적용된 모듈 API 및 기능의 주요 변경 사항이 나열되어 있습니다.
기사 및 가이드
- Qt Quick 3D 소개 예제
- Qt Quick 3D glTF 자산을 활용한 소개
- Qt Quick 3D 그래픽 요구 사항
- Qt Quick 3D 아키텍처
- Balsam 에셋 임포트 도구
- 3D 에셋 최적화
- 물리 기반 렌더링
- 이미지 기반 조명 사용
- 앤티앨리어싱 모범 사례
- Qt Quick 3D 2D 콘텐츠가 포함된 씬
- 프로그래밍 가능한 머티리얼, 이펙트, 지오메트리 및 텍스처 데이터
- 스켈레탈 애니메이션
- 모핑 애니메이션
- 인스턴스 렌더링
- 디테일 수준(LOD)
- 사용자 지정 머티리얼 에디터
- 라이트맵 및 전역 조명
- 섀도 매핑
- Qt Quick 3D Xr
- 다중 뷰 렌더링
- 셰이더의 디스크 기반 캐싱
예제
- 소개
- 여러 뷰포트가 있는 View3D
- 조명과 그림자
- 동적 모델 생성
- Principled 머티리얼
- 내장 효과 및 톤 매핑
- Qt Quick 3D 씬 내의 아이템
- 사용자 정의 머티리얼
- 음영 처리되지 않은 사용자 정의 머티리얼
- 사용자 정의 포스트 프로세싱 효과 작성
- C++에서 사용자 정의 지오메트리 추가
- C++에서 사용자 정의 텍스처 데이터 추가
- 베이킹된 라이트맵 사용하기
- 간단한 VR 씬 설정 방법 시연
- VR에서 컨트롤러 입력을 시연합니다
- VR에서 공간 앵커를 시연합니다
- 모든 예제
참고 자료
- Qt Quick 3D QML Types
- Qt Quick 3D C++ Classes
- Qt Quick 3D Helpers QML Types
- Qt Quick 3D Asset Utility QML Types
- Qt Quick 3D Particles3D QML Types
- Qt Quick 3D Xr
관련 모듈
Qt 아카데미 강좌
- Qt Quick 3D: 애니메이션
- Qt Quick 3D: 에셋 및 리소스
- Qt Quick 3D: 사용자 정의 머티리얼, 렌더링 설정 및 포스트 프로세싱
- Qt Quick 3D: 상호작용 및 성능 관리
- Qt Quick 3D: 조명 및 카메라
- Qt Quick 3D: 뷰, 씬 및 노드
라이선스 및 출처 표기
Qt Quick 3D 는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, GNU 일반 공중 사용 허가서(GNU General Public License) 버전 3에 따라 제공됩니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.
또한, Qt Quick 3D 에는 다음의 허용적인 라이선스에 따라 제공되는 제3자 모듈이 포함될 수 있습니다:
크리에이티브 커먼즈 제로 v1.0 유니버설 | |
MIT 라이선스 | |
MIT 라이선스 | |
아파치 라이선스 2.0 | |
MIT 라이선스 | |
MIT 라이선스 | |
BSD 3조항 "New" 또는 "Revised" 라이선스 | |
아파치 라이선스 2.0 | |
BSD 3조항 "New" 또는 "Revised" 라이선스 | |
아파치 라이선스 버전 2.0 | |
MIT 라이선스 | |
MIT 라이선스 |
© 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.