발삼 에셋 임포트 툴

Balsam 툴은 Qt Quick 3D 의 에셋 컨디셔닝 파이프라인의 일부인 명령줄 애플리케이션입니다. 이 툴의 목적은 Maya, 3ds Max 또는 Blender와 같은 디지털 콘텐츠 제작 툴에서 생성된 에셋을 효율적인 런타임 포맷으로 변환하여 Qt Quick 3D 에서 사용할 수 있도록 하는 것입니다. 실시간 렌더링에 사용하기 전에 에셋의 콘텐츠를 파싱하고 컨디셔닝하는 데 많은 리소스가 필요하므로 애플리케이션에서 직접 인터체인지 포맷을 참조하는 것은 불가능하며, 이치에 맞지 않기도 합니다. 대신 Balsam 툴을 통해 인터체인지 포맷을 QML 컴포넌트와 지오메트리 및 텍스처와 같은 리소스로 변환할 수 있습니다.

사용법:

balsam [options] sourceFilename

사용 예

testModel.fbx 파일에 포함된 3D 에셋을 balsam 으로 변환하려면 다음 명령을 사용합니다:

balsam testModel.fbx

그러면 다음과 같은 파일이 생성됩니다:

• meshes/testModel.mesh
• TestModel.qml

그런 다음 해당 QML 컴포넌트를 사용하여 Qt Quick 3D 프로젝트에서 사용할 수 있습니다:

import QtQuick3D

TestModel {
   id: modelInstance
}

지원되는 3D 에셋 유형

• 웨이브프론트 (.obj)
• COLLADA (.dae)
• FBX (.fbx)
• STL (.stl)
• PLY (.ply)
• GLTF2 (.gltf, .glb)

지원되는 포맷 중 일부는 텍스처 에셋을 임베드하거나 참조할 수 있는 포맷도 있습니다. 이러한 에셋도 Qt에서 지원하는 경우 지원됩니다.

이미지 기반 조명을 위한 베이킹

발삼은 .hdr 파일에서 사전 필터링된 큐브맵 이미지를 생성하는 기능도 지원합니다. 확장자가 .hdr인 파일을 입력으로 지정하면 이름은 같지만 확장자가 .ktx인 파일이 생성됩니다. 그런 다음 애플리케이션은 결과 .ktx 파일을 전송하고 SceneEnvironment::lightProbe 과 연결된 Texture 에서 참조할 수 있습니다. 이렇게 하면 이미지 기반 조명에 필요한 비용이 많이 드는 런타임 처리를 피할 수 있습니다. 자세한 내용은 IBL 큐브맵 사전 생성을 참조하세요.

지원되는 옵션

다음 표에는 에셋 파일을 변환할 때 balsam 에서 인식하는 명령줄 옵션이 나열되어 있습니다: