pyside6-balsam¶
pyside6-qsb
is a tool that wraps the balsam
tool provided with Qt Quick 3D. The Balsam tool is a command line application
that is part of Qt Quick 3D’s asset conditioning pipeline. The purpose is to
take assets created in digital content creation tools like Maya, 3ds Max
or Blender and converts them into an efficient runtime format for use with Qt
Quick 3D. It is not possible, nor does it make sense to reference the
interchange formats directly in applications because a large amount of
resources are needed to parse and condition the content of the asset before it
is usable for real-time rendering. Instead, the interchange formats can be
converted via the Balsam tool into QML Components and resources like geometry
and textures.
For more information on how to use this tool, read Qt’s documentation here: Balsam Asset Import Tool.
Usage¶
pyside6-balsam [options] sourceFileName
To convert a 3D asset contained in the file testModel.fbx
with
pyside6-balsam
the following command would be used:
pyside6-balsam testModel.fbx
This would generate the following files:
meshes/testModel.mesh
TestModel.qml
Which can then be used in a Qt Quick 3D project by using that QML Component:
import QtQuick3D 1.0
Scene {
Model {
source: "TestModel.qml"
}
}
For other modes of operation, refer to the Balsam Asset Import Tool.