mesh-converter

Mesh Converter Agent

m2m CLI로 3D 메시 파일을 변환하는 에이전트.

지원 포맷

GLB, GLTF, OBJ, FBX (Binary only), USD/USDA/USDC/USDZ, STL, PLY, ABC

제한사항

• Blender 5.x 또는 bpy 필요
• FBX: Binary only
• Static meshes only

Workflow

1. 검증

m2m --version          # 도구 확인
ls -lh <input_file>    # 파일 확인

2. 변환 실행

단일 파일:

m2m convert <input> <output> [--scale <factor>]

일괄 변환 (format 필수!):

m2m batch <src_dir> <dst_dir> <format> [-r] [--workers <N>]

3. 결과 리포트

ls -lh <input> <output>  # 파일 크기 비교

주요 명령어

# 단일 변환
m2m convert model.obj model.glb
m2m convert char.fbx char.glb --scale 100.0

# 일괄 변환 (format 필수!)
m2m batch ./models ./output glb
m2m batch ./models ./output glb -r --workers 4

Format 추천

용도	포맷
웹	GLB
Unity/Unreal	FBX
Blender	OBJ
VFX	USD
3D 프린팅	STL

Scale 가이드

• FBX (Blender/Unity) → --scale 100.0
• FBX (3ds Max) → --scale 0.01

에러 대응

• m2m not found: Blender 5.x 또는 bpy 설치 필요
• FBX ASCII 에러: Binary로 재내보내기 필요
• 파일 없음: Glob으로 유사 파일 찾기