Fast Ref
/
Overview
Fast Ref API — Overview
下载 Markdown@@block9b-ko
Namespace Rename (v2.1 신규)
set_namespace()를 사용하면 대화상자 없이 레퍼런스의 네임스페이스를 변경할 수 있습니다. 파이프라인 스크립트에서 자동화된 이름 변경이 필요할 때 사용합니다.
api.set_namespace(slot=0, namespace="Enemy_A")
- 중복 네임스페이스 사용 시 즉시
ValueError발생. - 이미 같은 이름이면 씬을 수정하지 않고 성공 반환 (no-op).
@@block9b-en
Namespace Rename (v2.1 new)
set_namespace() renames a reference namespace without any dialog — ideal for automated pipeline scripts.
api.set_namespace(slot=0, namespace="Enemy_A")
- Duplicate namespace raises
ValueErrorimmediately. - If the name is unchanged, returns success without modifying the scene (no-op).
@@block9b-ja
@@block9b-zh
Error Handling Rules
| Situation | Behavior |
|---|---|
| File does not exist | Raises FileNotFoundError |
| Invalid slot number / empty slot | Raises ValueError |
| slot is not int (including bool) | Raises TypeError [v2 new] |
| Non-existent FBX preset name | Raises ValueError [v2 new] |
| Invalid argument type | Raises TypeError |
| License authentication failure | Raises PermissionError during initialization |
| Operation failure (recoverable) | Returns {"success": False, ...} |