Qt 3D

Qt 3D 는 Qt C++와 Qt Quick 애플리케이션 모두에서 2D 및 3D 렌더링을 지원하는 실시간에 가까운 시뮬레이션 시스템을 위한 기능을 제공합니다.

Qt 3D 의 기능은 다음과 같은 C++ 모듈로 나뉩니다:

다음 C++ 모듈은 아직 개발 중이지만 기술 미리보기로 제공됩니다:

Qt Quick 애플리케이션의 경우 Qt 3D 에서 다음 QML 모듈을 제공합니다:

다음 QML 모듈은 아직 개발 중이지만 기술 미리 보기로 사용할 수 있습니다:

모듈 사용

2D 또는 3D 렌더링, 충돌 감지를 수행하고 사용자 입력을 처리하는 C++ 애플리케이션의 경우 모듈 클래스의 다음 지시어를 포함하세요:

#include <Qt3DCore>
#include <Qt3DRender>
#include <Qt3DInput>
#include <Qt3DLogic>
#include <Qt3DExtras>
#include <Qt3DAnimation>

QML 유형을 애플리케이션으로 임포트하려면 .qml 파일에 다음 import 문을 사용합니다:

import Qt3D.Core
import Qt3D.Render
import Qt3D.Input
import Qt3D.Logic
import Qt3D.Extras
import Qt3D.Animation
import QtQuick.Scene2D
import QtQuick.Scene3D

Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리에 직접 또는 다른 종속성을 통해 링크해야 합니다. CMakeqmake를 비롯한 여러 빌드 도구가 이를 지원합니다.

CMake로 빌드하기

find_package() 명령을 사용하여 Qt6 패키지에서 필요한 모듈 컴포넌트를 찾습니다:

find_package(Qt6 REQUIRED COMPONENTS
    3DCore
    3DRender
    3DInput
    3DLogic
    3DExtras
    3DAnimation
)
target_link_libraries(mytarget PRIVATE
    Qt6::3DCore
    Qt6::3DRender
    Qt6::3DLogic
    Qt6::3DExtras
    Qt6::3DAnimation
)

qmake로 빌드하기

qmake로 빌드하기 위한 모듈을 구성하려면 프로젝트의 .pro 파일에 있는 QT 변수에 모듈을 추가합니다:

QT += 3dcore 3drender 3dinput 3dlogic 3dextras 3danimation

Qt Quick 애플리케이션에는 추가 종속성이 필요합니다:

QT += 3dcore 3drender 3dinput 3dlogic 3dextras 3danimation qml quick 3dquick

개요

Qt 3D 에 대한 높은 수준의 설계와 동기는 Qt 3D 개요에 설명되어 있습니다. Qt 3D 렌더는 Qt 3D 렌더 프레임그래프에 설명된 대로 데이터 기반 구성을 지원합니다.

참조

Qt 3D 플랫폼 지원

Qt 3D 는 다음과 같은 플랫폼을 지원합니다:

  • Microsoft Windows(win32) - 지원됨
  • Linux X11 - 지원됨
  • macOS - 지원되지만 일부 망막 크기 조정 문제가 있을 수 있습니다.
  • Android - 지원됨
  • 임베디드 Linux - 지원됨
  • iOS - (Qt 5.7) 이후 지원됨
  • WinRT - 아직 지원되지 않음

모듈 진화

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

라이선스 및 속성

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

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

Dear ImGui - ProggyClean.ttf

MIT 라이선스

Dear ImGui - stb

MIT 라이선스 또는 퍼블릭 도메인

Dear ImGui, version v1.91.0

MIT 라이선스

Open Asset Import Library, version 5.4.3

BSD 3항 "신규" 또는 "개정" 라이선스 사용자

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