Fast Ref
/
API Reference
/
Core
set_unpack()
지정된 슬롯의 Unpack 상태를 전환합니다.
- ON (Unpack): Top Group의 자식 노드들을 월드로 분리 (Unparent)
- OFF (Repack): 분리된 노드들을 다시 Top Group으로 복귀 (Reparent)
시그니처
api.set_unpack(slot: int, on: bool) -> dict
파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
slot |
int |
슬롯 번호 (0–9) |
on |
bool |
True = Unpack, False = Repack |
반환값
{
"success": True,
"message": str,
}
예외
| 예외 | 조건 |
|---|---|
ValueError |
슬롯이 유효하지 않거나 비어 있을 때 |
RuntimeError |
Unpack 처리 자체가 실패했을 때 |
예제
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()
api.set_unpack(slot=0, on=True) # Unpack
api.set_unpack(slot=0, on=False) # Repack