add_reference() — Fast Ref API Reference

.max 파일을 새 레퍼런스로 추가합니다. 비어 있는 슬롯에 자동으로 배정됩니다.

시그니처

api.add_reference(file_path: str) -> dict

파라미터

파라미터	타입	설명
`file_path`	`str`	추가할 `.max` 파일의 절대 경로

반환값

{
    "success": True,
    "message": str,
    "slot": int,
}

예외

예외	조건
`FileNotFoundError`	파일이 디스크에 존재하지 않을 때
`ValueError`	슬롯 10개가 모두 사용 중일 때

예제

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
result = api.add_reference(r"J:\assets\character_A.max")

if result['success']:
    print(f"Added to slot {result['slot']}")

v2: 확인 다이얼로그 없이 자동으로 진행됩니다.