ノード一覧に戻る

領域情報

region_info

領域ごとの面積・範囲・中心・端接触・隣接IDをMapとして出力します

確認済み
解説あり

入力ポート

名前説明
領域
regions
RegionMap
必須
情報を取り出す RegionMap です

出力ポート

名前説明
情報
info
Map
領域ごとの情報Mapです
領域一覧
region_entries
List<Map>
Listノードへ接続できる領域ごとの情報です
領域数
region_count
Int
領域の数です
width
Int
RegionMapのピクセル幅です
高さ
height
Int
RegionMapのピクセル高さです

概要

各領域の面積・中心・外接矩形・端接触・隣接IDを Map データとして出力する 情報ノードです。「領域の中心に飾りを置く」「面積に応じて処理を変える」 といった、領域の数値情報を配線で使う場面の供給源になります。

  • カテゴリ: Generate / Region / Info
  • 用途: 領域を数値で確認する、後段の制御や条件分岐に使う、面積や中心位置をもとに配置や抽出を組み立てる

使い方のポイント

  • region_entries 出力を list_map / list_filter に通すと、 area / centroid_x などのキー名がそのまま式で使える (例: area > 50 で大きい領域だけの一覧)
  • 数値でなく選別結果が欲しいだけなら region_filter の方が短い。 こちらは中心座標など「数値そのもの」が要る時
  • デバッグにも有効: 面積のばらつきを見て生成パラメータを調整する

関連ノード

  • list_map / list_filter — 出力リストの加工
  • region_filter — 数値を介さない選別
  • region_adjacency — 隣接関係に特化した情報版
  • region_debug_preview — 目視での確認

出力Map

トップレベル:

キー 説明
width Int RegionMap の幅です。
height Int RegionMap の高さです。
region_count Int 領域数です。
wrap_x Bool 左右ループを持つかです。
wrap_y Bool 上下ループを持つかです。
regions List 各領域の情報一覧です。

同じ情報の主要部分は配線しやすい直接出力でも提供します。

出力 内容
region_entries List regions と同じ領域情報一覧。List Map / List Filterへ直接接続できます。
region_count Int 領域数です。
width / height Int RegionMapのピクセルサイズです。

regions 内の各Map:

キー 説明
id Int 領域IDです。
area Int 領域のピクセル面積です。
centroid_x / centroid_y Float 領域中心です。
bbox_x / bbox_y Int 外接矩形の左上座標です。
bbox_width / bbox_height Int 外接矩形のサイズです。
touches_left / touches_right Bool 表示上の左右端に接しているかです。
touches_top / touches_bottom Bool 表示上の上下端に接しているかです。
edge_touch Bool いずれかの表示端に接しているかです。
neighbor_count Int 隣接している領域IDの数です。
neighbors List 隣接している領域ID一覧です。

注意

隣接IDは入力 RegionMapwrap_x / wrap_y を考慮します。
端接触はタイルのループ接続ではなく、表示キャンバス上の端に触れているかを示します。

使い方

Region CellsRegion Merge SmallRegion Split Islands などの後ろに接続して、現在の領域数や面積、中心位置を確認します。

画像を生成するノードではありません。領域の属性を取り出し、後段の条件処理やデバッグに使うための情報ノードです。

領域ごとの面積や中心を確認したい時はこちらを使います。隣接ペアの接触辺数を細かく見たい場合は Region Adjacency、IDを視覚的に確認したい場合は Region Debug Preview が向いています。

ノード一覧に戻る
領域情報 — PixPipeline ノード解説