Qt Quick 3D

Qt Quick 3D 提供了一个高级 API，用于基于 Qt Quick。与使用外部引擎不同——后者会引发同步问题并增加额外的抽象层——Qt Quick 3D 为现有的Qt Quick 场景图提供了用于空间内容的扩展，并为该扩展后的场景图提供了一个渲染器。使用空间场景图时，可以将Qt Quick 的 2D 内容与 3D 内容混合使用。

Qt Quick 3D 此外，Qt Quick 3D Xr 还为 XR 和 VR 应用程序提供了支持。

使用该模块

QML API

可通过QtQuick3D 导入获取该模块的 QML 类型。要使用这些类型，请在您的 .qml 文件中添加以下导入语句：

import QtQuick3D

以下模块导入提供了额外功能：

import QtQuick3D.AssetUtils
import QtQuick3D.Helpers
import QtQuick3D.Particles3D
import QtQuick3D.Xr

C++ API

要使用 Qt 模块的 C++ API，需要将模块库链接到项目中，既可以直接链接，也可以通过其他依赖项间接链接。包括CMake和qmake 在内的多种构建工具都为此提供了专门的支持。

使用 CMake 构建

使用find_package() 命令在Qt6 软件包中定位所需的模块组件：

find_package(Qt6 REQUIRED COMPONENTS Quick3D)
target_link_libraries(mytarget PRIVATE Qt6::Quick3D)

更多详细信息，请参阅“使用 CMake 构建”概述。

使用 qmake 构建

要配置模块以便使用 qmake 进行构建，请在项目的 .pro 文件中将该模块作为QT 变量的值添加：

QT += quick3d

从源代码构建

从源代码构建时，请确保先构建来自qtdeclarative和qtshadertools仓库的模块和工具，因为没有这些组件就无法使用Qt Quick 3D 。强烈建议同时安装qtquicktimeline，否则将无法使用基于关键帧的动画。

此外，部分示例依赖于 Qt Quick Controls.

模块演变

Qt Quick 3D 中的变更列出了为 Qt 6 系列所做的模块 API 和功能方面的重大变更。

文章与指南

• Qt Quick 3D 入门示例
• Qt Quick 3D 使用 glTF 资源的入门
• Qt Quick 3D 图形要求
• Qt Quick 3D 架构
• Balsam 资源导入工具
• 3D 资源优化
• 基于物理的渲染
• 使用基于图像的照明
• 抗锯齿最佳实践
• Qt Quick 3D 包含 2D 内容的场景
• 可编程材质、特效、几何体和纹理数据
• 骨骼动画
• 变形动画
• 实例化渲染
• 细节等级
• 自定义材质编辑器
• 光照贴图与全局光照
• 阴影映射
• Qt Quick 3D Xr
• 多视图渲染
• 基于磁盘的着色器缓存

示例

• 简介
• 带多个视口的View3D
• 光照与阴影
• 动态模型创建
• Principled 材质
• 内置效果与色调映射
• Qt Quick 3D 场景中的元素
• 自定义材质
• 未着色的自定义材质
• 编写自定义后处理效果
• 从 C++ 添加自定义几何体
• 从 C++ 添加自定义纹理数据
• 使用烘焙光照贴图
• 演示如何搭建一个简单的VR场景
• 演示 VR 中的控制器输入
• 演示 VR 中的空间锚点
• 所有示例

参考

• Qt Quick 3D QML Types
• Qt Quick 3D C++ Classes
• Qt Quick 3D Helpers QML Types
• Qt Quick 3D Asset Utility QML Types
• Qt Quick 3D Particles3D QML Types
• Qt Quick 3D Xr

相关模块

• Qt Quick

Qt Academy 课程

• Qt Quick 3D：动画
• Qt Quick 3D: 素材与资源
• Qt Quick 3D: 自定义材质、渲染设置与后处理
• Qt Quick 3D: 交互与性能管理
• Qt Quick 3D: 灯光与摄像机
• Qt Quick 3D: 视图、场景与节点

许可与署名

Qt Quick 3D 本软件在The Qt Company 的商业许可下提供。此外，它还遵循GNU 通用公共许可证第 3 版。更多详情请参阅Qt 许可说明。

此外，Qt Quick 3D 可能包含以下宽松许可协议下的第三方模块：