FBX Export Options

FBX Export Patterns

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

A non-existent preset name immediately raises 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,
    }
)

Note: ResetRootMode
- "auto" — automatically finds the top bone in the skin hierarchy
- "manual" — uses the bone matching the name in ResetRootName

Key FBX Options Reference