merge_reference() — Fast Ref API Reference

지정된 슬롯의 레퍼런스 하나를 씬 일반 오브젝트로 변환합니다. 컨테이너 해제, 레이어 구조 해체, InfoNode 정리를 수행합니다. 노드 이름(네임스페이스/suffix)은 변경하지 않습니다.

시그니처

api.merge_reference(slot: int) -> dict

파라미터

파라미터	타입	설명
`slot`	`int`	Merge할 슬롯 번호 (0–9)

반환값

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

예외

예외	조건
`ValueError`	슬롯이 유효하지 않거나 비어 있을 때
`RuntimeError`	Merge 처리 자체가 실패했을 때

예제

import sys, os, pymxs
_p = os.path.join(pymxs.runtime.getDir(pymxs.runtime.Name("userScripts")), "os_fast_ref_package")
if _p not in sys.path: sys.path.append(_p)

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
result = api.merge_reference(slot=0)
print(result['message'])

주의: 되돌릴 수 없는 작업입니다. Merge 후에는 해당 슬롯의 레퍼런스 데이터가 삭제됩니다.