Balsam 자산 가져오기 도구

Balsam 도구는 Qt Quick 3D 의 자산 처리 파이프라인에 포함된 애플리케이션입니다. 이 도구의 목적은 Maya, 3ds Max, Blender와 같은 디지털 콘텐츠 제작 도구에서 생성된 자산을 Qt Quick 3D 에서 사용할 수 있도록 효율적인 런타임 형식으로 변환하는 것입니다. 애플리케이션에서 교환 형식을 직접 참조하는 것은 불가능할 뿐만 아니라, 자산의 콘텐츠를 실시간 렌더링에 사용할 수 있도록 파싱하고 처리하는 데 막대한 리소스가 필요하기 때문에 합리적이지도 않습니다. 대신, 교환 형식을 Balsam 도구를 통해 QML 컴포넌트와 지오메트리, 텍스처와 같은 리소스로 변환할 수 있습니다.

Balsam 명령줄 도구

명령줄에서 Balsam을 실행하려면 다음과 같이 balsam 실행 파일을 호출하십시오.

balsam [options] sourceFilename

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

balsam testModel.fbx

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

• meshes/testModel.mesh
• TestModel.qml

생성된 파일은 해당 QML 컴포넌트를 사용하여 Qt Quick 3D 프로젝트에서 활용할 수 있습니다:

import QtQuick3D

TestModel {
   id: modelInstance
}

Balsam UI

balsam 실행 파일과 함께 제공되는 ‘ balsamui ’라는 Balsam용 GUI 프론트엔드도 있습니다. balsamui 에서 입력 파일과 출력 디렉터리를 선택할 수 있으며, balsam 실행 파일의 명령줄 옵션이 대화형 요소로 매핑되어 있습니다:

지원되는 3D 자산 유형

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

지원되는 일부 형식에서는 텍스처 에셋을 삽입하거나 참조할 수도 있습니다. Qt에서도 해당 형식을 지원하는 경우, 이러한 에셋도 지원됩니다.

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

Balsam은 또한 .hdr 파일을 사용하여 사전 필터링된 큐브맵 이미지를 생성하는 기능을 지원합니다. 입력으로 .hdr 확장자를 가진 파일을 지정하면, 동일한 이름이지만 확장자가 .ktx인 파일이 생성됩니다. 그런 다음 애플리케이션은 생성된 .ktx 파일을 포함시켜 배포하고, ` SceneEnvironment::lightProbe`와 연관된 ` Texture `에서 이를 참조할 수 있습니다. 이를 통해 이미지 기반 라이팅에 필요한 비용이 많이 드는 런타임 처리를 피할 수 있습니다. 자세한 내용은 IBL 큐브맵 사전 생성을 참조하십시오.

지원되는 옵션

다음 표는 자산 파일을 변환할 때 balsam 에서 인식하는 명령줄 옵션을 나열합니다: