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 리셋 후 적용할 회전값 (도 단위)
💬

Need help with the API?

Open a support ticket or join the community discussion.

Contact Support