Outil d'importation d'actifs Balsam

L'outil Balsam est une application qui fait partie du pipeline de conditionnement des actifs de Qt Quick 3D. L'objectif est de prendre les actifs créés dans des outils de création de contenu numérique tels que Maya, 3ds Max ou Blender et de les convertir dans un format d'exécution efficace pour une utilisation avec Qt Quick 3D. Il n'est pas possible, et cela n'a pas de sens, de référencer les formats d'échange directement dans les applications car une grande quantité de ressources est nécessaire pour analyser et conditionner le contenu de l'actif avant qu'il ne soit utilisable pour le rendu en temps réel. Au lieu de cela, les formats d'échange peuvent être convertis via l'outil Balsam en composants QML et en ressources telles que la géométrie et les textures.

Outil de ligne de commande Balsam

Pour exécuter Balsam via la ligne de commande, appelez l'exécutable balsam comme suit :

balsam [options] sourceFilename

Pour convertir une ressource 3D contenue dans le fichier testModel.fbx en balsam, il faut utiliser la commande suivante :

balsam testModel.fbx

Cela génère les fichiers suivants :

• meshes/testModel.mesh
• TestModel.qml

qui peuvent ensuite être utilisés dans un projet 3D Qt Quick en utilisant ce composant QML :

import QtQuick3D

TestModel {
   id: modelInstance
}

Interface utilisateur de Balsam

Il existe également une interface graphique pour Balsam, appelée balsamui, qui est livrée avec l'exécutable balsam. Dans balsamui, vous pouvez sélectionner vos fichiers d'entrée et votre répertoire de sortie, et les options de ligne de commande de l'exécutable balsam sont associées à des éléments interactifs :

Types d'actifs 3D pris en charge

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

Certains des formats pris en charge permettent également d'incorporer ou de référencer des éléments de texture. Ces actifs sont également pris en charge, à condition que Qt les prenne également en charge.

Création d'un éclairage basé sur l'image

Balsam prend également en charge la génération d'une image cubemap pré-filtrée à partir de fichiers .hdr. La spécification d'un fichier avec l'extension .hdr en tant qu'entrée entraîne la génération d'un fichier portant le même nom mais avec une extension .ktx. L'application peut alors expédier le fichier .ktx résultant et y faire référence à partir de Texture associé à SceneEnvironment::lightProbe. Cela permet d'éviter le traitement coûteux au moment de l'exécution qui est nécessaire pour l'éclairage basé sur l'image. Voir Pré-génération de cubemap IBL pour plus de détails.

Options prises en charge

Le tableau suivant répertorie les options de ligne de commande reconnues par balsam lors de la conversion des fichiers de ressources :