Fast Ref API — 概览

Fast Ref API 是供外部脚本自动化 Fast Ref 工作流的 Python 接口。

v2 主要变更

设计原则

API 方法列表（30 个）

@@block9a-ko

Fast_Ref Export Type (FBX + Alembic)

FBX / Alembic 모두 동일한 Fast_Ref Options 키로 최종 select를 필터합니다.

• ExportMeshes / ExportBones (기본 True) — 둘 다 False → FAIL FAST
• ResetRoot는 Export Type과 무관하게 전체 bone list로 먼저 처리
• FBX의 Skin은 FBX API(스킨/웨이트) 전용 — 노드 선택 필터가 아님

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

# Alembic (preset 예: Unreal_UE5, Unity_ABC)
api.export_abc(
    slot=0,
    output_path=r"J:\output\char.abc",
    preset="Unreal_UE5",
    abc_options={"ExportMeshes": True, "ExportBones": False},
)

@@block9a-en

Fast_Ref Export Type (FBX + Alembic)

FBX and Alembic share the same Fast_Ref Options keys for the final select filter.

• ExportMeshes / ExportBones (default True) — both False → FAIL FAST
• ResetRoot uses the full bone list first, independent of Export Type
• FBX Skin is FBX API (skin/weights) only — not the node selection filter

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

# Alembic (presets e.g. Unreal_UE5, Unity_ABC)
api.export_abc(
    slot=0,
    output_path=r"J:\output\char.abc",
    preset="Unreal_UE5",
    abc_options={"ExportMeshes": True, "ExportBones": False},
)

@@block9a-ja

@@block9a-zh

@@block9b-ko

Namespace Rename (v2.1 신규)

set_namespace()를 사용하면 대화상자 없이 레퍼런스의 네임스페이스를 변경할 수 있습니다. 파이프라인 스크립트에서 자동화된 이름 변경이 필요할 때 사용합니다.

api.set_namespace(slot=0, namespace="Enemy_A")

• 중복 네임스페이스 사용 시 즉시 ValueError 발생.
• 이미 같은 이름이면 씬을 수정하지 않고 성공 반환 (no-op).

@@block9b-en

Namespace Rename (v2.1 new)

set_namespace() renames a reference namespace without any dialog — ideal for automated pipeline scripts.

api.set_namespace(slot=0, namespace="Enemy_A")

• Duplicate namespace raises ValueError immediately.
• If the name is unchanged, returns success without modifying the scene (no-op).

@@block9b-ja

@@block9b-zh

Error Handling Rules