Balsam 资产导入工具

Balsam 工具是Qt Quick 3D 资产预处理管道中的一部分。其目的是将使用Maya、3ds Max 或Blender等数字内容创作工具创建的资产，转换为适用于Qt Quick 3D 的高效运行时格式。 在应用程序中直接引用交换格式既不可行，也没有实际意义，因为在资产内容可用于实时渲染之前，需要消耗大量资源来解析和处理其内容。相反，可以通过Balsam工具将交换格式转换为QML组件以及几何体和纹理等资源。

Balsam 命令行工具

要通过命令行运行 Balsam，请按以下方式调用balsam 可执行文件：

balsam [options] sourceFilename

若要将文件testModel.fbx 中包含的 3D 资源转换为balsam ，可使用以下命令：

balsam testModel.fbx

这将生成以下文件：

• meshes/testModel.mesh
• TestModel.qml

随后可通过使用相应的 QML 组件，在Qt Quick 3D 项目中使用这些文件：

import QtQuick3D

TestModel {
   id: modelInstance
}

Balsam 用户界面

Balsam 还提供了一个名为balsamui 的图形用户界面（GUI）前端，该前端随balsam 可执行文件一同发布。在balsamui 中，您可以选择输入文件和输出目录，而balsam 可执行文件的命令行选项会被映射到交互式控件上：

支持的 3D 资源类型

• Wavefront (.obj)
• COLLADA (.dae)
• FBX (.fbx)
• STL (.stl)
• PLY (.ply)
• GLTF2 (.gltf, .glb)

部分受支持的格式还允许嵌入或引用纹理资源。只要 Qt 也支持这些格式，这些资源同样受到支持。

基于图像的照明烘焙

Balsam 还支持从 .hdr 文件生成预过滤的立方贴图图像。指定一个扩展名为 .hdr 的文件作为输入，将生成一个同名但扩展名为 .ktx 的文件。 随后，应用程序可以打包生成的 .ktx 文件，并通过与SceneEnvironment::lightProbe 关联的Texture 引用该文件。这样可以避免基于图像的照明所需的耗时运行时处理。更多详细信息请参阅《预生成 IBL 立方体贴图》。

支持的选项

下表列出了balsam 在转换资源文件时支持的命令行选项：