PySide6.QtQuick3D

详细描述

提供API，允许您使用QML定义3D项目。

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

Qt Quick 3D 还为 XR 和 VR 应用程序提供了 Qt Quick 3D Xr。

../../_images/dragon.jpg

使用模块

QML API

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

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

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进行构建，请将模块作为QT变量的值添加到项目的.pro文件中：

QT += quick3d

从源代码构建

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

此外，一些示例依赖于Qt Quick Controls。

模块演变

Qt Quick 3D 的变更 列出了在 Qt 6 系列中对模块 API 和功能所做的重要更改。

文章和指南

  • Qt Quick 3D 介绍示例

  • 使用glTF资产的Qt Quick 3D介绍

  • Qt Quick 3D 图形需求

  • Qt Quick 3D 架构

  • Balsam资产导入工具

  • 优化3D资源

  • 基于物理的渲染

  • 使用基于图像的照明

  • 抗锯齿最佳实践

  • 带有2D内容的Qt Quick 3D场景

  • 可编程材料、效果、几何和纹理数据

  • 构建时材料

  • 骨骼动画

  • 变形动画

  • 实例化渲染

  • 细节层次

  • 自定义材质编辑器

  • 光照贴图和全局光照

  • 阴影映射

  • Qt Quick 3D Xr

  • 多视图渲染

示例

  • 介绍

  • 具有多个视口的View3D

  • 光与影

  • 动态模型创建

  • 原则性材料

  • 内置效果和色调映射

  • 3D场景中的Qt Quick项目

  • 自定义材料

  • 未着色的自定义材料

  • 编写自定义后处理效果

  • 从C++添加自定义几何体

  • 从C++添加自定义纹理数据

  • 使用烘焙光照贴图

  • 演示如何设置一个简单的VR场景

  • 演示VR中的控制器输入

  • 展示VR中的空间锚点

  • 所有示例

参考

Qt学院课程

许可证和归属

Qt Quick 3D 可从 The Qt Company 获得商业许可证。此外，它也可以在 GNU 通用公共许可证第 3 版下使用。有关更多详细信息，请参阅 Qt 许可。

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

该模块还提供了QML类型。

班级列表

A

我

Q

T