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를 사용하려면 모듈 라이브러리에 직접 또는 다른 종속성을 통해 링크해야 합니다. CMakeqmake를 비롯한 여러 빌드 도구가 이를 지원합니다.

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 없이는 사용할 수 없으므로 qtdeclarativeqtshadertools 저장소의 모듈과 도구가 먼저 빌드되었는지 확인하세요. 그렇지 않으면 키프레임 기반 애니메이션을 사용할 수 없으므로 qtquicktimeline도 사용할 수 있도록 하는 것이 좋습니다.

또한 이 예제 중 일부는 Qt Quick Controls.

모듈 진화

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

기사 및 가이드

예제

레퍼런스

Qt 아카데미 강좌

라이선스 및 저작자 표시

Qt Quick 3DThe Qt Company의 상용 라이선스에 따라 제공됩니다. 또한 GNU 일반 공중 사용 허가서 버전 3에 따라 사용할 수 있습니다. 자세한 내용은 Qt 라이선스를 참조하십시오.

또한 Qt Quick 3D 에는 다음과 같은 허용 라이선스에 따라 타사 모듈이 포함될 수 있습니다:

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

MIT 라이선스

Open Asset Import Library, version 5.4.3

BSD 3-절 "신규" 또는 "수정" 라이선스 사용자

OpenXR SDK, version 1.0.34

아파치 라이선스 2.0

Tiny OpenEXR, version v1.0.9

BSD 3-절 "새" 또는 "수정" 라이선스

meshoptimizer, version v0.18

MIT 라이선스

xatlas, version 16ace528acd2cf1f16a7c0dde99c42c486488dbe

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.