convert_to_reference() — Fast Ref API Reference

3dsMax에서 현재 선택된 오브젝트들을 Fast Ref 레퍼런스로 변환합니다. API 호출 전에 3dsMax에서 오브젝트를 선택해 두어야 합니다.

시그니처

api.convert_to_reference(namespace: str = None) -> dict

파라미터

파라미터	타입	설명
`namespace`	`str`	네임스페이스 이름. `None`이면 자동 생성

반환값

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

예외

예외	조건
`ValueError`	선택된 오브젝트가 없거나 슬롯이 가득 찼을 때
`RuntimeError`	변환 실패 시

예제

# Select objects in 3ds Max first, then call:
from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
result = api.convert_to_reference(namespace="MyCharacter")

print(f"Converted to slot {result['slot']}  (ns: {result['namespace']})")

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