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 许可