ノード一覧に戻る

レギオン切り出し

region_extract_sprites

画像をレギオンごとに切り出して、小さな画像のリストにします。1枚の絵を再利用できるパーツ集にしたいときに便利です。岩壁を石ころ素材に分けたり、キャラ絵をパーツ分解して別々に動かしたり、といった使い方ができます

確認済み
解説あり

入力ポート

名前説明
画像
image
Image
必須
切り出す元の画像です
領域
regions
RegionMap
必須
切り出す位置です。1つの領域が1枚のスプライトになります

出力ポート

名前説明
スプライト
sprites
List<Image>
切り出されたパーツのリストです(領域ID順)。領域の形の外側は透明になります
枚数
count
Int
切り出された枚数です

パラメータ

名前既定値範囲説明・選択肢
余白
padding
Int
00–32

各スプライトの周りに足す透明な余白(px)です。後からパーツに輪郭線や光彩を付ける予定があるときに便利です

サイズ統一
uniform_size
Bool
false

全スプライトを同じサイズに揃えます(最大の破片に合わせて中央配置)。スプライトシートやアニメのコマとして使うときはオンにしてください

概要

1枚の絵を「パーツ集」に変えるノードです。レギオンで区切った場所ごとに小さな画像を切り出してリストにするので、岩壁→石ころ素材、木→葉と幹、キャラ→パーツ分解、のような再利用素材づくりが一気にできます。

使い方のポイント

  • 定番のつなぎ方: 画像 + レギオン生成ノード → region_extract_spriteslist_get で1枚取り出し、または sprite_sheet_pack 系でシート化
  • スプライトは領域のぴったりサイズ(bbox)で切り出され、領域の形の外側は透明になります
  • アニメのコマや同サイズ前提の処理に流すときは「サイズ統一」をオンにします(最大の破片に合わせて中央配置)
  • 後から輪郭線や光彩を付ける予定があるなら「余白」を2〜4px足しておくとはみ出しません

よくある失敗

  • 切り出しが欠ける — レギオンと画像のサイズが違うと、画像の範囲外は切り出せません。レギオン生成の幅・高さを画像に合わせてください
  • 1個の石が2枚に分かれる — 同じIDの領域が離れていると1枚にまとまります。逆に別々にしたいときは region_split_islands で島ごとに別IDへ分けてから繋いでください

関連ノード

  • region_split_islands — 離れた同ID領域を別IDに分けてから切り出す
  • region_burst — 切り出さずにその場で破片として飛ばす
  • list_get / list_map — リストから取り出して個別に加工する
ノード一覧に戻る