ソケットの種類とデータフロー
この記事では、ノードグラフのソケットで使われるデータ型と、どこに接続できるかを説明します。
簡単なルール
多くの処理ノードは Spine Payload を扱います。アトラス関連ノードは Atlas Project または Sprites を扱います。ソケットが何を期待しているか不明な場合は ValidatorNode を使ってください。
ソケット型
- Spine Payload — ランタイム向けに整形された Spine プロジェクト表現。ほとんどの処理ノードが使用します。
- Atlas Project — アトラスのメタデータ + ページ画像。アトラス系ノードが使用します。
- Sprites — 展開されたスプライト/リージョン（Atlas Unpacker → アセット表示 / Atlas Repacker）。
- JSON — 診断/検証/差分のための、元または再構築された Spine JSON。
- 変更 — 一部の最適化ノードが生成する差分（diff）のリスト/ストリーム。表示/レポート用ノードで使用されます。
キー → 型 → 接続先
| ソケットキー（例） | データ型 | 生成元 | 接続先 |
|---|---|---|---|
payload, payload_in, payload_out | Spine Payload | InputNode, ほとんどの処理ノード | 処理ノード（RDP/Spline/Refit/Quantizer/Cleanup/etc.）→ OutputNode.payload |
original_json | JSON | InputNode | DiagnosticNode, JSONDiffNode.json_before, OutputNode.original_json, 一部のアトラス系ノード（例: repacker alpha mode） |
reconstructed_json_out | JSON | OutputNode | JSONDiffNode.json_after, バリデータ/デバッグ |
changes | 変更リスト | 一部の処理ノード + OutputNode | AnimationViewerNode（任意）, レポート/デバッグ |
atlas_project | Atlas Project | InputNode / アトラス表示 | AtlasUnpackerNode.atlas_project, OutputNode.atlas_project, アトラスフィルター |
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.