Fast Ref
/
Examples
FBX Export Options
FBX 옵션 활용 패턴
패턴 1 — 특정 키만 덮어쓰기
기본 프리셋은 유지하면서 일부 옵션만 바꿉니다.
import sys, os, pymxs
_p = os.path.join(pymxs.runtime.getDir(pymxs.runtime.Name("userScripts")), "os_fast_ref_package")
if _p not in sys.path: sys.path.append(_p)
from os_fast_ref.api import FastRefAPI
api = FastRefAPI()
api.export_fbx(slot=0, output_path=r"J:\output\char.fbx",
fbx_options={"Animation": False})
패턴 2 — 기본값 복사 후 수정
기본값 전체를 가져온 뒤 원하는 부분만 바꿔서 전달합니다.
import sys, os, pymxs
_p = os.path.join(pymxs.runtime.getDir(pymxs.runtime.Name("userScripts")), "os_fast_ref_package")
if _p not in sys.path: sys.path.append(_p)
from os_fast_ref.api import FastRefAPI
api = FastRefAPI()
defaults = api.get_fbx_default_options()
opts = defaults['options']
opts['UpAxis'] = 'Y'
opts['ConvertUnit'] = 'm'
api.export_fbx_all(output_folder=r"J:\output", fbx_options=opts)
패턴 3 — Root 0,0,0 리셋
내보내기 전 Root 노드의 Transform을 원점으로 초기화합니다. "manual" 모드는 ResetRootName으로 지정한 이름의 노드를 직접 찾아 기준점으로 사용합니다.
import sys, os, pymxs
_p = os.path.join(pymxs.runtime.getDir(pymxs.runtime.Name("userScripts")), "os_fast_ref_package")
if _p not in sys.path: sys.path.append(_p)
from os_fast_ref.api import FastRefAPI
api = FastRefAPI()
api.export_fbx(
slot=0,
output_path=r"J:\output\char.fbx",
fbx_options={
"ResetRoot": True,
"ResetRootMode": "manual",
"ResetRootName": "Root",
"ResetAxisX": 0.0,
"ResetAxisY": 0.0,
"ResetAxisZ": 0.0,
}
)
참고: ResetRootMode
"auto"— Skin된 본 계층을 타고 올라가 루트를 자동 추정"manual"—ResetRootName으로 지정한 이름의 노드를 명시적으로 사용
주요 FBX 옵션 목록
| 키 | 타입 | 설명 |
|---|---|---|
Animation |
bool |
애니메이션 포함 여부 |
Skin |
bool |
메시 포함 여부 (False면 Bone만 내보냄) |
Shape |
bool |
Morph Target(Shape) 포함 여부 |
BakeAnimation |
bool |
키프레임 베이크 여부 |
SmoothingGroups |
bool |
Smoothing Group 포함 여부 |
EmbedTextures |
bool |
텍스처 파일 임베드 여부 |
ASCII |
bool |
FBX ASCII 형식 여부 (False = Binary) |
UpAxis |
str |
Up 축 설정 ("Y" 또는 "Z") |
ConvertUnit |
str |
단위 변환 ("cm", "m" 등) |
RemoveNameSpace |
bool |
내보내기 전 네임스페이스 제거 여부 |
ResetRoot |
bool |
Root Transform 리셋 여부 |
ResetRootMode |
str |
Root 탐색 방식 ("auto" 또는 "manual") |
ResetRootName |
str |
manual 모드에서 찾을 노드 이름 |
ResetAxisX/Y/Z |
float |
Root 리셋 후 적용할 회전값 (도 단위) |