Инструмент импорта активов Balsam

Инструмент Balsam — это приложение командной строки, которое является частью конвейера подготовки активов Qt Quick 3D. Его цель — принимать активы, созданные в инструментах создания цифрового контента, таких как Maya, 3ds Max или Blender, и преобразовывать их в эффективный формат для выполнения с Qt Quick 3D. Невозможно и нецелесообразно напрямую ссылаться на форматы обмена в приложениях, потому что для обработки и подготовки содержимого актива перед его использованием для рендеринга в реальном времени требуется значительное количество ресурсов. Вместо этого форматы обмена могут быть преобразованы с помощью инструмента Balsam в компоненты QML и ресурсы, такие как геометрия и текстуры.

Использование:

balsam [options] sourceFilename

Пример использования

Для преобразования 3D актива, содержащегося в файле testModel.fbx с помощью balsam будет использоваться следующая команда:

balsam testModel.fbx

Это сгенерирует следующие файлы:

• meshes/testModel.mesh
• TestModel.qml

которые затем можно использовать в проекте Qt Quick 3D, используя этот компонент QML:

import QtQuick3D

TestModel {
   id: modelInstance
}

Поддерживаемые типы 3D активов

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

Некоторые из поддерживаемых форматов также позволяют встраивать или ссылаться на текстурные активы. Эти активы также поддерживаются, при условии, что Qt также поддерживает их.

Выпечка для освещения на основе изображения

Balsam также поддерживает генерацию предварительно отфильтрованной кубовой карты из файлов .hdr. Указание файла с расширением .hdr в качестве входных данных приводит к генерации файла с тем же именем, но с расширением .ktx. Затем приложение может отправить получившийся файл .ktx и сослаться на него из текстуры, связанной с SceneEnvironment::lightProbe. Это позволяет избежать дорогостоящей обработки в реальном времени, необходимой для освещения на основе изображения. Более подробную информацию см. в разделе Предварительная генерация кубовой карты IBL.

Поддержка проектов Qt 3D Studio

Инструмент Balsam также поддерживает преобразование проектов, созданных с помощью Qt 3D Studio, в проекты Qt Quick 3D QML.

• Приложение Qt 3D Studio (.uia)
• Презентация Qt 3D Studio (.uip)

Преобразование проектов Qt 3D Studio имеет некоторые ограничения из-за различий в доступных функциях. Функции, такие как эффекты и пользовательские материалы, недоступны и не будут генерироваться. Также есть некоторые различия в том, как реализованы анимации, поэтому при преобразовании могут возникнуть различия в поведении. Процесс преобразования не будет на 100% точным, и ожидается, что некоторые корректировки потребуются, но должен облегчить процесс переноса существующих проектов.

Поддерживаемые опции

В следующей таблице перечислены опции командной строки, распознаваемые balsam при преобразовании файлов активов:

В следующей таблице перечислены опции командной строки, распознаваемые balsam при преобразовании проектов Qt 3D Studio: