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 ValueError immediately.
  • 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, ...}
💬

Need help with the API?

Open a support ticket or join the community discussion.

联系支持