Balsam资产导入工具

Balsam Asset Import Tool

Balsam资产导入工具

The Balsam tool is a command line application that is part of Qt Quick 3D's asset conditioning pipeline. The purpose is to take assets created in digital content creation tools like Maya, 3ds Max, or Blender and convert them into an efficient runtime format for use with Qt Quick 3D. It is not possible, nor does it make sense to reference the interchange formats directly in applications because a large amount of resources are needed to parse and condition the content of the asset before it is usable for realtime rendering. Instead the interchange formats can be converted via the Balsam tool into QML Components and resources like geometry and textures.

​Balsam工具是一个命令行应用程序，是Qt Quick 3D资产调节管道的一部分。其目的是获取在数字内容创建工具（如Maya、3ds Max或Blender）中创建的资源，并将其转换为有效的运行时格式，以便与Qt Quick 3D一起使用。在应用程序中直接引用交换格式是不可能的，也没有意义的，因为需要大量资源来解析和调整资产的内容，然后才能将其用于实时呈现。相反，交换格式可以通过Balsam工具转换为QML组件和资源，如几何体和纹理。

Usage:

用法：

balsam [options] sourceFilename

Example Usage

示例用法

To convert a 3D asset contained in the file testModel.fbx with balsam the following command would be used:

转换文件testModel.fbx中包含的三维资源，将使用以下命令：

balsam testModel.fbx

This would generate the following files:

这将生成以下文件：

• meshes/testModel.mesh
• TestModel.qml

Which can then be used in a Qt Quick 3D project by using that QML Component:

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

import QtQuick3D

TestModel {
   id: modelInstance
}

Supported 3D Asset Types

支持的3D资产类型

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

Some of the formats supported also allow for either embedding or referencing of texture assets. These assets are also supported, provided Qt also has support for them.

支持的某些格式还允许嵌入或引用纹理资源。这些资产也受到支持，前提是Qt也支持它们。

Baking for Image-Based Lighting

基于图像的照明烘焙

Balsam also supports generating a pre-filtered cubemap image from .hdr files. Specifying a file with .hdr extension as the input results in generating a file with the same name but with an extension of .ktx. The application can then ship the resulting .ktx file and reference that from the Texture associated with SceneEnvironment::lightProbe. This avoids the costly runtime processing that is necessary for image-based lighting. See Pre-generating IBL cubemap for more details.

​Balsam还支持从.hdr文件生成预过滤的立方体映射图像。将扩展名为.hdr的文件指定为输入会生成一个名称相同但扩展名为.ktx的文件。然后，应用程序可以发送生成的.ktx文件，并从与SceneEnvironment::lightProbe关联的纹理中引用该文件。这避免了基于图像的照明所需的昂贵的运行时处理。有关详细信息，请参见预生成IBL立方体映射。

Supported Options

支持的选项

The following table lists the command-line options recognized by balsam when converting asset files:

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

Note: For each boolean option it is possible to use --disable-<option-name>

注意：对于每个布尔选项，可以使用--disable-＜选项名称＞

© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.