merge_all_references()

씬의 모든 레퍼런스를 일반 오브젝트로 변환하고 Fast Ref 트래킹 데이터를 전부 제거합니다. 되돌릴 수 없는 일방향 작업입니다.

내부 처리 순서:

• Phase 0 — 전체 Space Activate 강제 ON
• Phase 1 — 순서대로 Space Activate OFF (.rN suffix 일관성 보장)
• Phase 2 — 역순으로 Merge (Unpack → Merge → 데이터 제거)
• Phase 3 — Suffix 정리 (옵션 기반)

시그니처

api.merge_all_references(
    remove_node_suffix: bool = True,
    remove_layer_suffix: bool = False,
    remove_selectionset_suffix: bool = True,
) -> dict

파라미터

반환값

{
    "success": bool,
    "message": str,
    "merged_count": int,
    "failed_count": int,
}

예제

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_all_references(
    remove_node_suffix=True,
    remove_layer_suffix=True,
    remove_selectionset_suffix=True,
)
print(result['message'])
# → "Merge 완료: 3개 성공, 0개 실패"

주의: remove_layer_suffix=True는 동일한 기본 이름을 가진 레이어들을 병합합니다. 의도적으로 같은 이름의 레이어를 사용하는 경우 주의가 필요합니다.