Balsam 资产导入工具

Balsam 工具是一个命令行应用程序，是Qt Quick 3D 资产调节管道的一部分。其目的是将在Maya、3ds Max 或Blender等数字内容创建工具中创建的资产转换为高效的运行时格式，以便在Qt Quick 3D 中使用。在应用程序中直接引用交换格式是不可能的，也是不合理的，因为需要大量资源来解析和调节资产内容，然后才能用于实时渲染。相反，交换格式可以通过 Balsam 工具转换为 QML 组件以及几何图形和纹理等资源。

使用方法

balsam [options] sourceFilename

使用示例

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

balsam testModel.fbx

这将生成以下文件：

• meshes/testModel.mesh
• TestModel.qml

然后可在Qt Quick 3D 项目中使用该 QML 组件：

import QtQuick3D

TestModel {
   id: modelInstance
}

支持的 3D 资产类型

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

支持的某些格式还允许嵌入或引用纹理资产。只要 Qt 也支持这些资产，我们就同样支持它们。

基于图像的照明烘焙

Balsam 还支持从 .hdr 文件生成预过滤的立方体贴图图像。指定一个扩展名为 .hdr 的文件作为输入，会生成一个扩展名为 .ktx 的同名文件。然后，应用程序就可以发送生成的 .ktx 文件，并从与SceneEnvironment::lightProbe 相关联的Texture 中引用该文件。这就避免了基于图像的照明所需的高成本运行时处理。更多详情，请参阅预生成 IBL 立方体地图。

支持的选项

下表列出了balsam 在转换资产文件时可识别的命令行选项：