Qt 3D

Qt 3D provides functionality for near-realtime simulation systems with support for 2D and 3D rendering in both Qt C++ and Qt Quick applications.

Qt 3D 功能被划分成下列 C++ 模块：

Qt 3D Core C++ 类	Qt 3D 模块包含支持近实时仿真系统的功能。
Qt 3D Input C++ 类	Qt 3D Input 模块提供用于在使用 Qt3D 的应用程序中处理用户输入的类。
Qt 3D Logic C++ 类	Qt 3D Logic 模块使帧能够与 Qt 3D 后端同步。
Qt 3D Render C++ 类	Qt 3D Render 模块包含使用 Qt 3D 支持 2D 和 3D 渲染的功能。

下列 C++ 模块仍在开发，但可用作技术预览：

Qt 3D Animation C++ 类	Qt 3D Animation 模块提供一套预构建元素，以帮助您入门 Qt 3D。
Qt 3D Extras C++ 类	Qt 3D Extras 模块提供一套预构建元素，以帮助您入门 Qt 3D。
Qt 3D Scene2D C++ 类	Qt 3D Scene2D 模块提供把 Quick2 QML 内容渲染成 Qt 3D 纹理的办法。

对于 Qt Quick 应用程序，Qt 3D 提供下列 QML 模块：

Qt 3D Core QML 类型	提供核心 Qt 3D QML 类型。
Qt 3D Input QML 类型	为 Qt 3D 用户输入提供 QML 类型。
Qt 3D Logic QML 类型	提供同步帧与 3D 后端的 QML 类型。
Qt 3D Render QML 类型	为渲染提供 Qt 3D QML 类型。

下列 QML 模块仍在开发，但可用作技术预览：

Qt 3D Extras QML 类型	为 Extras 模块提供 Qt 3D QML 类型。
Qt 3D Qt3DAnimation QML 类型	为动画模块提供 Qt 3D QML 类型。
Qt 3D Scene2D QML 类型	为 Scene2D 模块提供 Qt 3D QML 类型。
Qt 3D Scene3D QML 类型	为 Scene3D 模块提供 Qt 3D QML 类型。

使用模块

For a C++ application that performs 2D or 3D rendering, collision detection, and handles user input, include the following directives of the modules' classes:

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

要导入 QML 类型到应用程序中，使用以下 import 语句在 .qml 文件中：

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 and 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 构建

To configure the module for building with qmake, add the modules to the QT 变量在工程的 .pro 文件：

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

A Qt Quick application requires additional dependencies:

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

概述

Qt 3D 高级设计、动机的描述在 Qt 3D 概述 . The Qt 3D Render offers support for data-driven configuration as described in Qt 3D 渲染 FrameGraph .

参考

Qt 3D 平台支持

Qt 3D 支持下列平台：

微软 Windows (win32) - 支持
Linux X11 - 支持
macOS - 支持 (尽管可能有一些视网膜比例缩放问题)
Android - 支持
嵌入式 Linux - 支持
iOS - 从 Qt5.7 起支持
WinRT - 尚不支持

模块演变

Qt3D 的变化列出了 Qt 的 Qt 6 系列在模块 API 和功能上所做出的重要改变。

许可和归属

Qt 3D 在商业许可下是可用的来自 Qt 公司。此外，它是可用的根据 GNU LGPL (次一般公共许可) 第 3 版，或 GNU GPL (一般公共许可) 第 2 版。见 Qt 许可进一步了解细节。

此外，Qt 3D 包含的第 3 方模块遵循下列准许许可：

Dear ImGui - ProggyClean.ttf	MIT 许可
Dear ImGui - stb	MIT 许可或公共领域
Dear ImGui，第 v1.66b 版	MIT 许可