Back to Node List

Region Debug Preview

region_debug_preview

Renders RegionMap with region id labels for inspection

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
領域
regions
RegionMap
Required
確認する RegionMap です

Output Ports

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

Parameters

NameTypeDefaultRangeDescription / Options
背景
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ピクセル縁取り色です

Overview

A review-only node that overlays ID numbers on a RegionMap. It is a workbench for visually determining which ID to specify in nodes such as region_mask and region_distance, and is not intended for production output.

  • Category: Generate / Region / Render
  • Uses: choosing IDs for Region Mask, adjusting region area, and inspecting region-splitting results

Usage tips

  • Make a habit of connecting this before selecting IDs. It is essential after region_remap or region_split_islands, which change the numbering.
  • The show_ids option on generation nodes provides the same review. Insert this node when you need to inspect an intermediate state in a processing chain.
  • Use min_area to omit labels when small regions overlap.

Related nodes

  • region_mask / region_filter / region_distance — production nodes that select IDs
  • region_remap — a common upstream node that changes numbering
  • region_info / region_adjacency — numeric region information

Background

Value Description
RegionColor Fill each region with a random color
RegionGray Fill each region with a random gray
Transparent Keep the background transparent and draw only ID labels

Placement

Value Description
Centroid Place the label near the region's centroid
BoundsCenter Place the label at the center of the bounding rectangle

How to use

Connect Region Cells.regions -> Region Debug Preview.regions to show the ID over each region. Use it before specifying Id or IdRange in Region Mask.

With the default label_style = Overlay, IDs are not baked into the image; they appear as UI labels over the Inspector preview. Labels overlap easily on small regions, so use min_area to omit them. Use Font, Tiny, or Small only when the numbers must be baked into an image.

This node is for review. Use its IDs to configure Region Mask, Region Filter, Region Distance, and similar nodes. For ordinary production output, use Region Fill, Region Pattern Assign, or Region Border.

Back to Node List
Region Debug Preview — PixPipeline Node Reference