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 UI

また、Balsam用のGUIフロントエンドとして「balsamui 」があり、これは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 が認識するコマンドラインオプションの一覧です。