ノード一覧に戻る

領域マスク

region_mask

RegionMap の選択領域を白アルファのマスク画像に変換します

確認済み
解説あり

入力ポート

名前説明
領域
regions
RegionMap
必須
マスク化する RegionMap です

出力ポート

名前説明
マスク
output
Image
選択した領域から作った白アルファマスクです

パラメータ

名前既定値範囲説明・選択肢
方式
mode
Enum
All

どの条件で領域をマスク化するかです

  • 全領域All
    すべての領域を選択します
  • ID指定Id
    指定した領域IDだけを選択します
  • ID範囲IdRange
    指定したID範囲の領域を選択します
  • 面積範囲AreaRange
    ピクセル面積の範囲で領域を選択します
  • ランダムRandom
    領域ごとの安定したランダム値で選択します
領域ID
region_id
Int
00–2147483647

ID指定方式で選ぶ領域IDです

最小ID
min_id
Int
00–2147483647

ID範囲方式で選ぶ最小IDです

最大ID
max_id
Int
2550–2147483647

ID範囲方式で選ぶ最大IDです

最小面積
min_area
Int
00–4294967295

選択する領域の最小ピクセル面積です

最大面積
max_area
Int
40960–4294967295

選択する領域の最大ピクセル面積です

確率
chance
Float
0.50–1 / step 0.01

ランダム方式で各領域を選ぶ確率です

シード
seed
Int
10–99999

ランダム選択に使うシードです

反転
invert
Bool
false

選択領域と非選択領域を反転します

概要

RegionMap から「選んだ領域だけの白黒マスク」を取り出すノードです。 リージョンシステムと通常の画像ノード群(mask / blend_by_mask / mask_scatter)を つなぐ橋渡し役で、「この地層にだけ苔を生やす」「この面だけ明るくする」といった 領域限定の加工を可能にします。

使い方のポイント

  • 定番の流れ: 領域を作る → このノードでIDを選んでマスク化 → blend_by_mask で その範囲だけ補正/mask_scatter でその範囲に散布

  • 選び方は All/ID指定など方式から選ぶ。IDは region_debug_previewshow_ids で確認しながら

  • 連続した複数IDは IdRange で選ぶ。離れたIDはIDごとにマスクを作り、 mask_boolean で合成する

  • カテゴリ: Generate / Region / Select

  • 用途: 領域単位で MaskBlendMask Scatter などの既存画像ノードへ渡したい時

方式

説明
All すべての領域を白マスクにします。
Id region_id と一致する領域だけを白マスクにします。
IdRange min_id から max_id までの領域を白マスクにします。
AreaRange 面積が min_area から max_area の範囲に入る領域だけを白マスクにします。小さい欠片だけ消す、または大きい面だけ取り出す用途に使います。
Random 領域IDごとに安定したランダム値を作り、chance 以下の領域だけを白マスクにします。

使い方

Region Cells.regions -> Region Mask.regions と接続し、Region Mask.outputMaskBlendMask Scatter などへ渡します。

例:

Region Cells.regions -> Region Mask.regions
Region Mask.output -> Mask.mask

Region Fill は領域を見た目として塗り分けるノード、Region Mask は領域を既存の画像処理に渡すための選択ノードです。

regions 入力が評価されると、region_idmin_idmax_id の範囲は実際の領域IDに、min_areamax_area の範囲は実際の最大領域面積に合わせて更新されます。

Region Filter との違いは出力型です。Region Mask は通常画像の白アルファマスクを出します。領域データのまま後段へ渡したい場合は Region FilterRegion Neighbor Select を使います。

関連ノード

  • blend_by_mask / mask / mask_scatter — 出したマスクの使い先
  • region_filter — 領域データのまま絞り込む場合
  • mask_boolean — 複数マスクの合成
  • region_debug_preview — 対象IDの確認
ノード一覧に戻る
領域マスク — PixPipeline ノード解説