이 페이지에서는

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

소스 코드 빌드

소스 코드에서 빌드할 때는 qtdeclarative 및 qtshadertools 저장소의 모듈과 도구를 먼저 빌드해야 합니다. 이 요소들이 없으면 Qt Quick 3D 를 사용할 수 없기 때문입니다. 또한 키프레임 기반 애니메이션을 사용하려면 qtquicktimeline이 반드시 필요하므로, 이를 사용할 수 있도록 하는 것이 강력히 권장됩니다.

또한, 일부 예제에서는 Qt Quick Controls.

모듈의 발전

Qt Quick 3D 의 변경 사항에는 Qt 6 시리즈를 위해 적용된 모듈 API 및 기능의 주요 변경 사항이 나열되어 있습니다.

기사 및 가이드

예제

참고 자료

Qt 아카데미 강좌

라이선스 및 출처 표기

Qt Quick 3D 는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, GNU 일반 공중 사용 허가서(GNU General Public License) 버전 3에 따라 제공됩니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.

또한, Qt Quick 3D 에는 다음의 허용적인 라이선스에 따라 제공되는 제3자 모듈이 포함될 수 있습니다:

Blue Noise Texture

크리에이티브 커먼즈 제로 v1.0 유니버설

Godot Engine: Fog

MIT 라이선스

Godot Engine: ProceduralSky

MIT 라이선스

Intel Embree, version 3.13.3

아파치 라이선스 2.0

Java Native Interface for C++, version 1.0.0

MIT 라이선스

JsonCpp, version 1.9.6

MIT 라이선스

Open Asset Import Library, version 6.0.5

BSD 3조항 "New" 또는 "Revised" 라이선스

OpenXR SDK, version 1.1.61

아파치 라이선스 2.0

Tiny OpenEXR, version 1.0.13

BSD 3조항 "New" 또는 "Revised" 라이선스

closestPointOnTriangle

아파치 라이선스 버전 2.0

meshoptimizer, version 1.2

MIT 라이선스

xatlas, version 16ace528acd2cf1f16a7c0dde99c42c486488dbe

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.