ノード一覧に戻る

レギオンID確認

region_debug_preview

各レギオンに色分けとID番号を重ねた確認用の画像を作ります。「ID指定で選びたいけど、あの面が何番か分からない」というときに繋いで、番号を見ながら作業します

確認済み
解説あり

入力ポート

名前説明
領域
regions
RegionMap
必須
確認する RegionMap です

出力ポート

名前説明
画像
output
Image
領域確認用画像です
ラベル
labels
Map
Inspector に重ねるIDラベル位置です

パラメータ

名前既定値範囲説明・選択肢
背景
background
Enum
RegionColor

確認用背景の描き方です

  • 領域色RegionColor
    領域ごとに決定論的な色を塗ります
  • 領域グレーRegionGray
    領域ごとに決定論的なグレーを塗ります
  • 透明Transparent
    透明背景にラベルだけを描きます
シード
seed
Int
10–99999

背景色のランダム割り当てに使うシードです

ID表示
show_ids
Bool
true

領域IDラベルを描画します

最小表示面積
min_area
Int
80–4096

このピクセル面積未満の領域にはIDを表示しません

ラベル形式
label_style
Enum
Overlay

ラベルの描画方式です

  • UI重ね表示Overlay
    画像に焼き込まず、Inspector 上のUIラベルとして表示します
  • フォントFont
    通常フォントでラベルを描きます
  • 極小Tiny
    2x3の極小ビットマップ数字で描きます
  • Small
    3x5の読みやすいビットマップ数字で描きます
フォントサイズ
font_size
Int
84–32

フォントラベルの元画像上のピクセルサイズです

ラベル倍率
scale
Int
11–4

ビットマップ数字の倍率です

配置
placement
Enum
Centroid

ラベルを置く基準位置です

  • 重心Centroid
    各領域の重心付近にラベルを置きます
  • 範囲中央BoundsCenter
    各領域の外接矩形中央にラベルを置きます
ラベル色
label_color
Color
[1,1,1,1]

数字の色です

縁取り色
outline_color
Color
[0,0,0,1]

数字の背面に描く1ピクセル縁取り色です

概要

RegionMap にID番号を重ねて表示する確認専用ノードです。ID指定系の ノード(region_mask / region_distance 等)で「何番を指定すればいいか」を 目で確かめるための作業台で、制作物には使いません。

  • カテゴリ: Generate / Region / Render
  • 用途: Region Mask のID指定、領域の面積調整、領域分割結果の確認

使い方のポイント

  • ID指定の前に一度つなぐ癖をつけると迷子にならない。特に region_remap / region_split_islands の後は番号が変わるので必須
  • 各生成ノード自身の show_ids でも同じ確認ができる。このノードは 「加工チェーンの途中の状態」を見たい時に挟む
  • 小さい領域でラベルが重なるときは min_area で間引く

関連ノード

  • region_mask / region_filter / region_distance — ID指定の本番ノード
  • region_remap — 番号が変わる代表的な前段
  • region_info / region_adjacency — 数値としての領域情報

背景

説明
RegionColor 領域ごとにランダム色で塗ります。
RegionGray 領域ごとにランダムなグレーで塗ります。
Transparent 背景を透明にしてIDラベルだけを描きます。

配置

説明
Centroid 領域の重心付近に表示します。
BoundsCenter 領域の外接矩形中央に表示します。

使い方

Region Cells.regions -> Region Debug Preview.regions と接続すると、各領域の上にIDが表示されます。Region MaskIdIdRange を指定する前の確認用として使います。

既定の label_style = Overlay では、IDは画像に焼き込まれず、Inspector のプレビュー上にUIラベルとして重なります。小さい領域ではラベルが重なりやすいため、min_area で小領域の表示を省いて確認してください。画像として焼き込みたい場合だけ Font / Tiny / Small を使います。

このノードは確認用です。ID番号を見て Region MaskRegion FilterRegion Distance などのID指定を決める時に使います。通常の制作出力へは Region FillRegion Pattern AssignRegion Border などを使ってください。

ノード一覧に戻る
レギオンID確認 — PixPipeline ノード解説