FBX Export Options — Fast Ref API

@@block6b-ko

Pattern 6 — Export Type filter (Meshes / Bones)

Fast_Ref Options 최종 select 필터. Alembic과 동일한 키입니다. Skin은 FBX API 전용입니다.

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()

# Meshes only
api.export_fbx(
    slot=0,
    output_path=r"J:\output\char_mesh.fbx",
    fbx_options={"ExportMeshes": True, "ExportBones": False},
)

# Bones only (Unreal_Ani preset also sets this)
api.export_fbx(
    slot=0,
    output_path=r"J:\output\char_bones.fbx",
    preset="Unreal_Ani",
)

둘 다 False → FAIL FAST. ResetRoot는 Export Type과 무관하게 전체 bone list로 처리됩니다.

@@block6b-en

Pattern 6 — Export Type filter (Meshes / Bones)

Final Fast_Ref Options select filter. Same keys as Alembic. Skin is FBX API only.

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()

# Meshes only
api.export_fbx(
    slot=0,
    output_path=r"J:\output\char_mesh.fbx",
    fbx_options={"ExportMeshes": True, "ExportBones": False},
)

# Bones only (Unreal_Ani preset also sets this)
api.export_fbx(
    slot=0,
    output_path=r"J:\output\char_bones.fbx",
    preset="Unreal_Ani",
)

Both False → FAIL FAST. ResetRoot uses the full bone list, independent of Export Type.

@@block6b-ja

@@block6b-zh

Key FBX Options Reference

Key	Type	Description
`Animation`	`bool`	Include animation data
`Skin`	`bool`	FBX API skin/weights flag (node select uses Export Type)
`ExportMeshes`	`bool`	Include meshes in final select (default `True`)
`ExportBones`	`bool`	Include bones in final select (default `True`)
`Shape`	`bool`	Include Morph Target (Shape) data
`BakeAnimation`	`bool`	Bake keyframes (remove controllers)
`SmoothingGroups`	`bool`	Include smoothing groups
`EmbedTextures`	`bool`	Embed textures into the FBX file
`ASCII`	`bool`	Use FBX ASCII format (False = Binary)
`UpAxis`	`str`	Up-axis direction (`"Y"` or `"Z"`)
`ConvertUnit`	`str`	Unit conversion (`"cm"`, `"m"`, etc.)
`RemoveNameSpace`	`bool`	Remove namespace prefix after export
`ResetRoot`	`bool`	Reset Root node transform before export
`ResetRootMode`	`str`	Root detection mode (`"auto"` or `"manual"`)
`ResetRootName`	`str`	Root bone name for manual mode
`ResetAxisX/Y/Z`	`float`	Target rotation for root reset (degrees)