Balsam-Asset-Import-Tool

Das Balsam-Tool ist eine Befehlszeilenanwendung, die Teil der Asset-Aufbereitungspipeline von Qt Quick 3D ist. Es dient dazu, Assets, die in Tools zur Erstellung digitaler Inhalte wie Maya, 3ds Max oder Blender erstellt wurden, in ein effizientes Laufzeitformat für die Verwendung mit Qt Quick 3D zu konvertieren. Es ist nicht möglich und auch nicht sinnvoll, die Austauschformate direkt in Anwendungen zu referenzieren, da eine große Menge an Ressourcen benötigt wird, um den Inhalt des Assets zu analysieren und aufzubereiten, bevor es für das Echtzeit-Rendering verwendet werden kann. Stattdessen können die Austauschformate mit dem Balsam-Tool in QML-Komponenten und Ressourcen wie Geometrie und Texturen konvertiert werden.

Verwendung:

balsam [options] sourceFilename

Beispiel für die Verwendung

Um ein 3D-Asset, das in der Datei testModel.fbx enthalten ist, mit balsam zu konvertieren, würde der folgende Befehl verwendet werden:

balsam testModel.fbx

Dies würde die folgenden Dateien erzeugen:

• meshes/testModel.mesh
• TestModel.qml

Diese können dann in einem Qt Quick 3D -Projekt unter Verwendung dieser QML-Komponente verwendet werden:

import QtQuick3D

TestModel {
   id: modelInstance
}

Unterstützte 3D-Asset-Typen

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

Einige der unterstützten Formate erlauben auch das Einbetten oder Referenzieren von Textur-Assets. Diese Assets werden ebenfalls unterstützt, sofern Qt sie ebenfalls unterstützt.

Baking für bildbasierte Beleuchtung

Balsam unterstützt auch die Erzeugung eines vorgefilterten Cubemap-Bildes aus .hdr-Dateien. Wenn eine Datei mit der Erweiterung .hdr als Eingabe angegeben wird, wird eine Datei mit dem gleichen Namen, aber mit der Erweiterung .ktx erzeugt. Die Anwendung kann dann die resultierende .ktx-Datei ausliefern und auf diese in der mit SceneEnvironment::lightProbe verbundenen Texture verweisen. Dadurch wird die kostspielige Laufzeitverarbeitung vermieden, die für bildbasierte Beleuchtung erforderlich ist. Weitere Informationen finden Sie unter Vorgenerierung von IBL-Cubemaps.

Unterstützte Optionen

In der folgenden Tabelle sind die Befehlszeilenoptionen aufgeführt, die von balsam bei der Konvertierung von Asset-Dateien erkannt werden: