よつばゲームズ

ノード一覧に戻る

スプライトシート取り込み

sprite_sheet_import

外部シートを解析して分割線と信頼度を確認し、確定したセルを余白なしの標準シートへ再配置します。

確認済み

解説あり

出力ポート

名前	型	説明
スプライトシート spritesheet	SpriteSheet	確定後に余白と間隔を除いて再配置した標準スプライトシートです
元画像 source	Image	選択した元画像です
分割線プレビュー overlay	Image	現在の候補または手動設定のセル境界を水色で重ねた確認画像です
信頼度 confidence	Float	自動検出候補の信頼度です。0.75以上を目安にし、それ未満は分割線をよく確認します
候補JSON candidate_json	Text	検出した列・行・セル寸法・余白・間隔です
警告コード warnings	Text	未確定、低信頼度、空セル、未使用領域を示す安定コードです
取り込みレポートJSON report_json	Text	取り込みアシスタント向けの構造化診断です

パラメータ

名前	型	既定値	範囲	説明・選択肢
シート画像 path	FilePath	—	—	分割を調べる外部スプライトシートを選びます。元ファイルは変更しません
分割設定 layout_mode	Enum	Detected	—	水色の分割線がフレームと合わないときだけ手動修正へ切り替えます自動候補`Detected` 透明な区切りから検出した候補を使います手動修正`Manual` 分割線が違うときに列・行・寸法・余白・間隔を直します
透明判定 alpha_threshold	Float	0.01	0–1 / step 0.01	この値以下の透明度を区切りとみなします。通常は0.01、縁に薄いノイズがある素材は0.05〜0.15が目安です
この分割で確定 confirmed	Bool	false	—	分割線を確認してから有効にします。未確定中はスプライトシート出力が安全な仮画像のままです
FPS fps	Int	12	1–60	確定シートへ保存する再生速度です。粗めのドット絵は8〜12、滑らかな動きは24が目安です
列数 columns	Int	1	0–128	横に並ぶフレーム数です
行数 rows	Int	1	0–128	縦に並ぶフレーム数です
フレーム幅 frame_width	Int	1	0–4096	余白を含まない1フレームの幅です
フレーム高さ frame_height	Int	1	0–4096	余白を含まない1フレームの高さです
左余白 margin_x	Int	0	0–4096	最初のセルまでの左余白です
上余白 margin_y	Int	0	0–4096	最初のセルまでの上余白です
横間隔 spacing_x	Int	0	0–4096	セル同士の横方向の間隔です
縦間隔 spacing_y	Int	0	0–4096	セル同士の縦方向の間隔です

概要

余白やセル間隔を含む外部スプライトシートを、PixPipelineの標準SpriteSheetへ安全に取り込みます。自動候補を即採用せず、水色の分割線と信頼度を確認してから確定できるため、フレームの切れや誤分割を下流へ流しません。

使い方のポイント

シート画像を選び、overlayをプレビュー対象にします。
信頼度0.75以上でも、全フレームが水色の枠内に収まることを確認します。
分割が違う場合は「手動修正」へ切り替え、列・行・フレーム寸法・左上余白・間隔を直します。
SPRITESHEET_EMPTY_CELLとSPRITESHEET_UNUSED_PIXELSを確認し、意図どおりなら「この分割で確定」を有効にします。

確定後は余白と間隔が除かれ、既存のSpriteSheetスキーマへ再配置されます。元画像や保存形式へmargin/spacingを追加しません。

よくある失敗

キャラクター内部にも完全透明な縦線・横線があると、自動候補が細かく分かれることがあります。信頼度が低い場合は手動修正を使います。
半透明の縁ノイズで区切りを見失う場合は「透明判定」を0.05〜0.15へ少しずつ上げます。上げすぎると薄いエフェクトまで透明扱いになるため、分割線を再確認してください。
未確定中のspritesheetは1x1の仮画像です。下流が空に見える場合は、確認後に「この分割で確定」を有効にします。

関連ノード

sprite_sheet_to_frames: 確定シートをフレーム列へ展開する場合
sprite_sheet_playback: 確定結果を再生確認する場合
sprite_sheet_info: すでに余白なしで分割情報だけを補いたい場合
image_sequence_import: 1フレーム1ファイルで届いた素材の場合

関連ノード

シートのコマ分解sprite_sheet_to_frames スプライトシート再生sprite_sheet_playback スプライトシート情報sprite_sheet_info 連番画像取り込みimage_sequence_import

ノード一覧に戻る