Fast Ref API 개요 (v2)

Fast Ref API는 외부 스크립트에서 Fast Ref 워크플로를 자동화하기 위한 Python 인터페이스입니다.

v2 주요 변경점

설계 원칙

API 메서드 목록 (20개)

핵심 개념

슬롯 (Slot)

Fast Ref는 레퍼런스를 0~9번 슬롯으로 관리합니다. v2에서는 slot이 반드시 int여야 합니다.

api.remove_reference(slot=0)     # OK
api.remove_reference(slot="0")   # TypeError: slot must be int
api.remove_reference(slot=True)  # TypeError: slot must be int

Space Activate

레퍼런스의 네임스페이스 적용 여부를 제어합니다. OFF 상태에서는 노드, 레이어, SelectionSet 이름에서 네임스페이스 접두사가 제거됩니다.

Unpack

레퍼런스 노드들을 최상위 그룹 컨테이너에서 분리해 월드로 꺼냅니다.

FBX 프리셋 (v2 신규)

export_fbx / export_fbx_all에 preset 키워드를 지정하면 저장된 프리셋을 이름 한 단어로 적용합니다.

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

존재하지 않는 프리셋 이름 → ValueError 즉시 발생.

반환값 구조

{"success": bool, "message": str}
# on failure, also includes:
{"success": False, "message": str, "error": str}

예외 처리 규칙