Qt Quick 3D

Qt Quick 3D 提供了一个高级应用程序接口，用于创建 3D 内容和 3D 用户界面。 Qt Quick.Qt Quick 3D 不使用会产生同步问题和额外抽象层的外部引擎，而是为现有的Qt Quick 空间内容场景图提供扩展，并为该扩展场景图提供渲染器。使用空间场景图时，可以将 Qt Quick 2D 内容与 3D 内容混合使用。

Qt Quick 3D 还可通过Qt Quick 3D Xr 实现 XR 和 VR 应用。

使用模块

QML API

模块的 QML 类型可通过QtQuick3D 导入。要使用这些类型，请在 .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 系列 Qt 在模块 API 和功能方面的重要变更。

文章和指南

• Qt Quick 3D 介绍示例
• Qt Quick 使用 glTF 资产的 3D 介绍
• Qt Quick 3D 图形要求
• Qt Quick 三维架构
• Balsam 资产导入工具
• 优化 3D 资产
• 基于物理的渲染
• 使用基于图像的照明
• 抗锯齿最佳实践
• Qt Quick 带有 2D 内容的 3D 场景
• 可编程材质、效果、几何图形和纹理数据
• 构建时材质
• 骨骼动画
• 变形动画
• 实例渲染
• 详细程度
• 自定义材质编辑器
• 光照贴图和全局照明
• 阴影贴图
• Qt Quick 3D Xr
• 多视图渲染

实例

• 介绍
• 使用多视口的 View3D
• 灯光与阴影
• 动态模型创建
• 原理材质
• 内置特效和色调映射
• 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 学院课程

• Qt Quick 3D：动画
• Qt Quick 3D：资产与资源
• Qt Quick 3D：自定义材质、渲染设置和后期处理
• Qt Quick 3D：交互与性能管理
• Qt Quick 3D：照明与相机
• Qt Quick 3D：视图、场景和节点

许可和归属

Qt Quick 3D 可在Qt Company 的商业许可下使用。此外，它还受GNU 通用公共许可证第 3 版的保护。有关详细信息，请参阅Qt 许可。

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