FBX Export Options

FBX 옵션 활용 패턴

Pattern 1 — Named preset (v2, recommended)

Apply a saved preset by name. The simplest approach.

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
api.export_fbx(slot=0, output_path=r"J:\output\char.fbx", preset="Unreal_Ani")
api.export_fbx_all(output_folder=r"J:\output", preset="Unreal")

존재하지 않는 프리셋 이름은 ValueError를 즉시 발생시킵니다.

Pattern 2 — Override specific keys only

Keep the default preset and change only some options.

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})

Pattern 3 — Copy defaults then modify

Fetch all defaults and change only what you need.

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
defaults = api.get_fbx_default_options()
opts = defaults['options'].copy()
opts['UpAxis'] = 'Y'
opts['ConvertUnit'] = 'm'
api.export_fbx_all(output_folder=r"J:\output", fbx_options=opts)

Pattern 4 — preset + partial override (v2)

Load a preset then override only specific options.

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
api.export_fbx(
    slot=0,
    output_path=r"J:\output\char.fbx",
    preset="Unreal_Ani",
    fbx_options={"BakeAnimation": False}
)

Pattern 5 — Reset Root to 0,0,0

Reset the Root node's transform to the origin before exporting.

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 옵션 목록