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 문을 추가하세요:
import QtQuick3D
다음 모듈 임포트는 추가 기능을 제공합니다:
import QtQuick3D.AssetUtils import QtQuick3D.Helpers import QtQuick3D.Particles3D import QtQuick3D.Xr
C++ 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
소스에서 빌드하기
소스에서 빌드할 때는 Qt Quick 3D 없이는 사용할 수 없으므로 qtdeclarative 및 qtshadertools 저장소의 모듈과 도구가 먼저 빌드되었는지 확인하세요. 그렇지 않으면 키프레임 기반 애니메이션을 사용할 수 없으므로 qtquicktimeline도 사용할 수 있도록 하는 것이 좋습니다.
또한 이 예제 중 일부는 Qt Quick Controls.
모듈 진화
Qt Quick 3D 의 변경 사항에는 Qt 6 시리즈에 적용된 모듈 API와 기능의 중요한 변경 사항이 나열되어 있습니다.
기사 및 가이드
- Qt Quick 3D 소개 예제
- Qt Quick 3D glTF 에셋 소개
- Qt Quick 3D 그래픽 요구 사항
- Qt Quick 3D 아키텍처
- 발삼 에셋 임포트 툴
- 3D 에셋 최적화
- 물리 기반 렌더링
- 이미지 기반 조명 사용
- 안티 에일리어싱 모범 사례
- Qt Quick 3D 2D 콘텐츠가 포함된 씬
- 프로그래밍 가능한 머티리얼, 효과, 지오메트리 및 텍스처 데이터
- 빌드 타임 머티리얼
- 스켈레탈 애니메이션
- 모핑 애니메이션
- 인스턴스 렌더링
- 레벨 오브 디테일
- 커스텀 머티리얼 에디터
- 라이트맵 및 글로벌 일루미네이션
- 섀도 매핑
- Qt Quick 3D Xr
- 멀티뷰 렌더링
예제
- 소개
- 다중 뷰포트가 있는 View3D
- 조명 및 그림자
- 동적 모델 생성
- 원칙적인 재질
- 기본 제공 효과 및 톤 매핑
- 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 일반 공중 사용 허가서 버전 3에 따라 사용할 수 있습니다. 자세한 내용은 Qt 라이선스를 참조하십시오.
또한 Qt Quick 3D 에는 다음과 같은 허용 라이선스에 따라 타사 모듈이 포함될 수 있습니다:
MIT 라이선스 | |
MIT 라이선스 | |
아파치 라이선스 2.0 | |
MIT 라이선스 | |
MIT 라이선스 | |
BSD 3-절 "신규" 또는 "수정" 라이선스 사용자 | |
아파치 라이선스 2.0 | |
BSD 3-절 "새" 또는 "수정" 라이선스 | |
MIT 라이선스 | |
MIT 라이선스 |
© 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.