소켓 타입 & 데이터 흐름
이 글은 노드 그래프의 소켓에서 사용되는 데이터 타입과, 어디에 무엇을 연결할 수 있는지 설명합니다.
간단한 규칙
대부분의 처리 노드는 Spine Payload를 대상으로 동작합니다. 아틀라스 관련 노드는 Atlas Project 또는 Sprites를 대상으로 동작합니다. 소켓이 무엇을 기대하는지 확실하지 않다면 ValidatorNode를 사용하세요.
소켓 타입
- Spine Payload — 대부분의 처리 노드가 사용하는 Spine 프로젝트의 런타임 친화적 표현입니다.
- Atlas Project — 아틀라스 노드에서 사용하는 아틀라스 메타데이터 + 페이지 이미지입니다.
- Sprites — 언팩된 스프라이트 이미지/리전(Atlas Unpacker → Asset Viewer / Atlas Repacker).
- JSON — 진단/검증/디핑을 위한 원본 또는 재구성된 Spine JSON입니다.
- Changes — 일부 최적화기가 생성하고 뷰어/리포팅 노드에서 사용하는 diff 목록/스트림입니다.
키 → 타입 → 연결
| 소켓 키(예시) | 데이터 타입 | 생성 주체 | 연결 대상 |
|---|---|---|---|
payload, payload_in, payload_out | Spine Payload | InputNode, 대부분의 처리 노드 | 처리 노드(RDP/Spline/Refit/Quantizer/Cleanup 등), 그리고 OutputNode.payload |
original_json | JSON | InputNode | DiagnosticNode, JSONDiffNode.json_before, OutputNode.original_json, 일부 아틀라스 노드(예: repacker alpha 모드) |
reconstructed_json_out | JSON | OutputNode | JSONDiffNode.json_after, validator/디버그 |
changes | Changes 목록 | 일부 처리 노드 + OutputNode | AnimationViewerNode(선택), 리포트/디버그 |
atlas_project | Atlas Project | InputNode / atlas viewer | AtlasUnpackerNode.atlas_project, OutputNode.atlas_project, atlas filter |
atlas_in, atlas_out | Atlas Project(또는 atlas 관련 스트림) | Atlas 노드 / 필터 | Atlas 노드, AtlasViewerNode, AtlasMergerNode(multi-input 사용) |
sprites_out, sprites_in, sprites_data_in | Sprites | AtlasUnpackerNode, 필터 | AssetViewerNode.sprites_in, AtlasRepackerNode.sprites_data_in |
atlas_inputs | 여러 Atlas Project | 여러 소스 | AtlasMergerNode.atlas_inputs(여러 아틀라스 연결) |
실전 파이프라인
- 기본 JSON 최적화:
InputNode→ (선택:DiagnosticNode/ 필터) → 최적화기(RDPNode,SplineNode,QuantizerNode, …) →OutputNode. - 아틀라스 재패킹:
InputNode.atlas_project→AtlasUnpackerNode→ (선택:AssetViewerNode) →AtlasRepackerNode→OutputNode.atlas_project/atlas_assets.