이 페이지에서는

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

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 Render는 Qt 3D Render Framegraph에 설명된 대로 데이터 기반 구성을 지원합니다.

참조

Qt 3D 플랫폼 지원

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

  • Microsoft Windows (win32) - 지원됨
  • Linux X11 - 지원됨
  • macOS - 지원되지만 레티나 스케일링 관련 문제가 발생할 수 있음
  • Android - 지원됨
  • 임베디드 리눅스 - 지원됨
  • iOS - (Qt 5.7)부터 지원됨
  • WinRT - 아직 지원되지 않음

모듈의 발전

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

라이선스 및 저작자 표시

Qt 3D 는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 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 6.0.5

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

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