开源入门

download source code

概述

Kuesa Runtime 是基于Qt3D的模块，提供以下功能:

• ​支持导入glTF2文件
• 用于访问/操作加载内容的帮助程序
• PBR and custom material support
• PBR和自定义材质的支持
• 定制的前向渲染路径，支持添加定制效果
• Custom forward renderer for adding effects
• A Qt Creator template for quickly creating new Kuesa based projects
• 针对QtCreator的工程模板，可以快速创建Kuesa应用

这是Kuesa 3D设计和集成工作流中面向开发者的部分

Kuesa Studio 是Kuesa方案中面向设计师的部分，提供以下功能:

• 主要的3D设计软件的glTF2导出器和特定于Kuesa的glTF扩展:
  • Kuesa for Blender
  • Kuesa for 3ds Max
  • Kuesa for Maya (coming soon)
• A library of real time materials that can be exported to glTF and previewed in Blender
• 可导出到glTF并能在Blender里面预览的实时材质库
• Tooling around asset conditionning to decrease asset size and optimize for embedded use cases.
• 围绕资产条件话的工作，以减少资产规模并优化嵌入式用例​
  

更多关于Kuesa Studio的信息可以在这里获得

---

需求

注意: 本仓库需要git-lfs工具的支持。
Kuesa Runtime 需要Qt 3D的支持，版本为Qt 5.12.8, Qt 5.14.2或者Qt 5.15

注意: Qt 5.12.8版本下，部分功能不支持

Qt 3D 的一些可选aspect(动画、逻辑)无法运行
https://codereview.qt-project.org/c/qt/qt3d/+/297123 修复了这个问题

1. Qt 5.12.8下载并安装 Qt 5.12.8
2. clone Qt3D: git clone [email protected]:qt/qt3d.git
3. go to 5.12 branch: git checkout -t origin/5.12
4. open a console with Qt setup (should be installed with Qt)
5. go to the Qt3D directory, and type: qmake && make - j4 && make install (or qmake; jom; jom install on Windows)

Earlier Qt 3D versions can still be used but might be suffering from bugs that have been identified and fixed since.

硬件 :

1. 桌面
Anything with OpenGL 3.2 support (or more recent) is adequate.
Currently supported operating systems are:

• Linux
• Windows
• Mac OS

2. 嵌入式 
以下是Kuesa成功测试的芯片组/设备列表:

• Apple iPad 5 (PowerVR GT7600)
• Apple iPhone 7
• OnePlus 3T (Android, Qualcolmm Snapdragon 821/Adreno 430)
• NVidia Tegra K1 (embedded Linux)
• iMX8 (embedded Linux)

Kuesa运行时支持opengles3.2或更高版本的任何东西.
支持OpenGL ES 3.1或更低版本，但功能集有限，具体取决于可用的OpenGL扩展.

• For HDR support, GL_OES_texture_half_float is required
• For anti aliasing, ARB_texture_multisample and GL_EXT_color_buffer_half_float are required​

---

可选择的依赖
​
Kuesa可以选择使用Draco网格压缩库，可以通过嵌入式版本，也可以通过系统上的现有版本。Draco可以用来显著减小glTF文件的大小。.

Kuesa支持这里定义的KHR draco mesh压缩glTF扩展。
​
默认情况下，Kuesa将使用自己的嵌入版本的Draco库进行构建。这可以通过：

qmake kuesa.pro -- --draco=qt

要在不支持Draco的情况下构建Kuesa，请像这样运行qmake:

qmake kuesa.pro -- --draco=no

要使用Draco的外部版本构建Kuesa，请像这样运行qmake:

qmake kuesa.pro -- --draco=system

如果Draco未安装在系统的默认位置，则可以将DRACOSDK环境变量设置为指向安装Draco的位置。使用DRACOSDK \u LIBS环境变量指向包含Draco库的文件夹。请注意，Kuesa最后一次使用Draco测试是在commit 8833cf878e6fd43c5a3fd6e42312e25e25e632。
Kuesa提供的glTF编辑器能够用Draco压缩现有的gltf2.0资产

---

组件
​
Kuesa运行时由:

• 具有核心类的Qt模块
• QML插件
• gltfViewer工具预览gltf2.0文件，包括选择相机和动画

---

安装
​
Kuesa构建为Qt模块，将与Qt一起安装。主要的优点是，一旦安装，在项目中使用Kuesa就像将Qt+=Kuesa添加到项目文件中一样简单。缺点是，如果您还不习惯构建Qt本身，那么从源代码构建Kuesa可能会更复杂一些。

注意：您不必从源代码构建Qt，根据Qt的预装版本构建Kuesa应该可以正常工作。

但是构建一个模块意味着Kuesa具有类似于从源代码构建Qt的依赖关系（关于如何从源代码构建Qt的说明可以在这里找到）。特别地：

perl必须安装并包含在路径中

如果已从github下载Kuesa作为存档，则必须在Kuesa源目录的根目录下创建一个空的.git文件夹。

一旦安装了这些，syncqt将能够在构建时生成模块头。简单运行：

qmake
make
make install

Should examples not be built, try:

make sub-examples
cd examples
make install
​
要安装Qt Creator模板，请将整个kuesa文件夹从tools/qtc\u templates复制到Qt Creator安装位置内的templates/wizards文件夹。

---

文档​
​
参考文件可从以下网址获得：https://kdab.github.io/kuesa/​

---

​第三方
​
Kuesa使用以下第三方软件:

• Qt 5.12或更高版本，根据LGPLv3授权网址：www.qt.io
• Draco，根据Apache License 2.0授权，由Google Inc.编写。https://github.com/google/draco
• MikkTSpace，根据定制许可证获得许可，由Morten S.Mikkelsen撰写http://mmikkelsen3d.blogspot.com/​​

---

Python绑定
​
一个基于PySide 2的python绑定工具。请检查src/python中的构建说明和examples/kuesa/python中的示例应用程序。​

---

支持
​​
请在此处提交问题
KDAB很乐意接受外部贡献；但是，所有贡献都需要签署贡献者许可协议。