Balsam-Asset-Import-Tool

Das Balsam-Tool ist eine Anwendung, 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 weder möglich noch sinnvoll, in Anwendungen direkt auf die Austauschformate zu verweisen, 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 über das Balsam-Tool in QML-Komponenten und Ressourcen wie Geometrie und Texturen konvertiert werden.

Balsam-Befehlszeilentool

Um Balsam über die Befehlszeile auszuführen, rufen Sie die ausführbare Datei „ balsam “ wie folgt auf:

balsam [options] sourceFilename

Um ein 3D-Asset aus der Datei „ testModel.fbx “ mit „ balsam “ zu konvertieren, würde folgender Befehl verwendet werden:

balsam testModel.fbx

Dadurch würden die folgenden Dateien generiert:

• meshes/testModel.mesh
• TestModel.qml

Diese können dann in einem „ Qt Quick 3D “-Projekt mithilfe dieser QML-Komponente verwendet werden:

import QtQuick3D

TestModel {
   id: modelInstance
}

Balsam-Benutzeroberfläche

Es gibt außerdem eine grafische Benutzeroberfläche für Balsam namens „ balsamui “, die zusammen mit der ausführbaren Datei „ balsam “ ausgeliefert wird. In „ balsamui “ können Sie Ihre Eingabedateien und das Ausgabeverzeichnis auswählen, und die Befehlszeilenoptionen der ausführbaren Datei „ balsam “ werden interaktiven Elementen zugeordnet:

Unterstützte 3D-Asset-Typen

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

Einige der unterstützten Formate ermöglichen zudem entweder die Einbettung oder die Referenzierung von Textur-Assets. Diese Assets werden ebenfalls unterstützt, sofern Qt sie ebenfalls unterstützt.

Baking für bildbasierte Beleuchtung

Balsam unterstützt zudem die Erstellung eines vorgefilterten Cubemap-Bildes aus .hdr-Dateien. Wird eine Datei mit der Endung .hdr als Eingabe angegeben, wird eine Datei mit demselben Namen, jedoch mit der Endung .ktx, erzeugt. Die Anwendung kann dann die resultierende .ktx-Datei ausliefern und über die mit „ SceneEnvironment::lightProbe “ verknüpfte „ Texture “ darauf verweisen. Dadurch wird die aufwändige Laufzeitverarbeitung vermieden, die für die bildbasierte Beleuchtung erforderlich ist. Weitere Details finden Sie unter „Vorabgenerierung der IBL-Cubemap “.

Unterstützte Optionen

Die folgende Tabelle listet die Befehlszeilenoptionen auf, die von balsam bei der Konvertierung von Asset-Dateien erkannt werden: