merge_all_references() — Fast Ref API Reference

씬의 모든 레퍼런스를 일반 오브젝트로 변환하고 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

파라미터

파라미터	타입	기본값	설명
`remove_node_suffix`	`bool`	`True`	Merge 후 노드 이름의 `.rN` suffix 제거
`remove_layer_suffix`	`bool`	`False`	레이어 이름의 `.rN` suffix 제거 (중복 레이어 통합)
`remove_selectionset_suffix`	`bool`	`True`	SelectionSet 이름의 `.rN` suffix 제거

반환값

{
    "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는 동일한 기본 이름을 가진 레이어들을 병합합니다. 의도적으로 같은 이름의 레이어를 사용하는 경우 주의가 필요합니다.