M2M CLI Reference

M2M CLI Reference

Overview

3D 메시 변환 CLI 도구. Blender 5.x 또는 bpy 패키지 필요.

지원 포맷: GLB, GLTF, OBJ, FBX (Binary only), USD/USDA/USDC/USDZ, STL, PLY, ABC

제한사항:

• Blender 5.x 또는 bpy 필요
• FBX: Binary only (ASCII 미지원)
• Static meshes only (애니메이션/리깅 미지원)

Commands

convert - 단일 파일 변환

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

예시:

m2m convert model.obj model.glb
m2m convert character.fbx character.glb --scale 100.0
m2m convert model.glb model.stl

batch - 일괄 변환

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

• <format>: 출력 포맷 (필수!) - glb, gltf, obj, fbx, usd, stl, ply, abc
• -r: 하위 디렉토리 포함
• --workers: 병렬 워커 수 (기본: CPU 코어 수)

예시:

m2m batch ./models ./output glb
m2m batch ./models ./output glb -r --workers 4

Format Guide

용도	추천 포맷
웹 (Three.js)	GLB
Unity/Unreal	FBX
Blender	OBJ
VFX/Film	USD
3D 프린팅	STL

Scale 조정

FBX 스케일 문제 해결:

• Blender/Unity export → --scale 100.0
• 3ds Max export → --scale 0.01

Quick Reference

m2m --version                    # 버전 확인
m2m convert in.fbx out.glb       # 단일 변환
m2m batch ./src ./dst glb        # 일괄 변환
m2m batch ./src ./dst glb -r     # 재귀 일괄 변환