Back to Node List

Region Neighbor Select

region_neighbor_select

Selects RegionMap areas by neighboring ids or edge contact

Draft
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
領域
regions
RegionMap
選択結果の RegionMap です
マスク
mask
Image
選択領域を白にしたマスクです
プレビュー
preview
Image
選択領域のプレビューです
ラベル
labels
Map
Inspector に重ねるIDラベル位置です

Parameters

NameTypeDefaultRangeDescription / Options
方式
mode
Enum
NeighborsOfId

領域の選択方法です

  • IDの隣接NeighborsOfId
    指定IDに接する領域を選択します
  • ID範囲の隣接NeighborsOfRange
    指定ID範囲に接する領域を選択します
  • 外側に接するTouchesOutside
    OUTSIDE ピクセルに接する領域を選択します
  • 画像端に接するTouchesEdge
    画像端に接する領域を選択します
  • 内側のみInteriorOnly
    外側や画像端に接しない領域を選択します
領域ID
region_id
Int
00–255

領域ID

最小ID
min_id
Int
00–255

最小ID

最大ID
max_id
Int
2550–255

最大ID

隣接段数
depth
Int
11–32

何段階隣まで含めるかです

起点を含む
include_source
Bool
false

隣接選択で起点IDも選択に含めます

出力方式
output_mode
Enum
KeepSelected

選択領域をどう出力するかです

  • 選択を残すKeepSelected
    選択領域だけを残します
  • 選択を除くRemoveSelected
    選択領域を取り除きます
シード
seed
Int
10–99999

シード

ID表示
show_ids
Bool
false

Inspector のプレビュー上に領域IDラベルを表示します

  • type_id: region_neighbor_select
  • category: Generate/Region/Select

RegionMap の隣接関係を使って、指定IDに接する領域、外側に接する領域、画像端に接する領域などを選択します。Region Adjacency が情報出力用なのに対し、このノードは後続処理へ渡せる RegionMap とマスクを出力します。

主なパラメータ

ID 内容
mode IDの隣接、ID範囲の隣接、外側接触、画像端接触、内側のみ
region_id / min_id / max_id 隣接選択の起点
depth 何段階隣まで含めるか
include_source 起点IDも選択に含める
output_mode 選択領域を残すか、選択領域を除くか
show_ids Inspector プレビューにIDラベルを表示

TouchesOutside は実際の OUTSIDE_ID に接している領域を選びます。画像端そのものに接している領域を選びたい場合は TouchesEdge を使います。

使い方

指定IDの周囲だけを別処理したい場合は、mode = NeighborsOfIddepth = 1 から始めます。2段階隣まで広げたい場合は depth を上げます。起点IDも含めたい時だけ include_source をオンにします。

出力 regions は選択した領域だけを残した RegionMap です。通常の画像マスクとして使う場合は mask を、さらに領域処理を続ける場合は regions を使います。

入力 RegionMap左右ループ / 上下ループ を持つ場合、隣接判定も端越しの接続を考慮します。タイル素材で端をまたぐ隣接を選びたい時に使えます。

Back to Node List
Region Neighbor Select — PixPipeline Node Reference