バルサムアセットインポートツール

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

QMLコンポーネントを使用することで、Qt Quick 3Dプロジェクトで使用することができます：

import QtQuick3D

TestModel {
   id: modelInstance
}

サポートされている3Dアセットタイプ

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

サポートされているフォーマットのいくつかは、テクスチャ アセットの埋め込みまたは参照も可能です。これらのアセットも、Qtがサポートしていればサポートされます。

画像ベースの照明のベイク

バルサムは、.hdr ファイルからフィルタリング済みのキューブマップ画像を生成することもサポートしています。.hdr拡張子を持つファイルを入力として指定すると、同じ名前で拡張子が.ktxのファイルが生成されます。アプリケーションは、生成された .ktx ファイルを出荷し、SceneEnvironment::lightProbe に関連付けられたTexture から参照することができます。これにより、画像ベースのライティングに必要なコストのかかるランタイム処理を回避できます。詳細はIBLキューブマップの事前生成を参照してください。

サポートされるオプション

次の表は、アセットファイルの変換時にbalsam で認識されるコマンドラインオプションの一覧です：