Back to Node List

Region Bands

region_bands

Generates directional band-like RegionMap areas

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
マスク
mask
Image
領域を生成する範囲を制限する任意の画像マスクです。マスクは 明度 * アルファ >= 0.5 のピクセルを有効範囲として扱います。マスク外は OUTSIDE_ID になります。

Output Ports

NameTypeDescription
領域
regions
RegionMap
生成された RegionMap データです
プレビュー
preview
Image
生成した領域を色分けした確認用画像です
ラベル
labels
Map
Inspector に重ねるIDラベル位置です

Parameters

NameTypeDefaultRangeDescription / Options
width
Int
641–2048

RegionMap のピクセル幅です

高さ
height
Int
641–2048

RegionMap のピクセル高さです

方向
direction
Enum
Horizontal

生成する帯の主方向です

  • Horizontal
    横方向の帯です
  • Vertical
    縦方向の帯です
  • 右下がりDiagonalDown
    左上から右下へ流れる帯です
  • 右上がりDiagonalUp
    左下から右上へ流れる帯です
帯数
band_count
Int
82–256

生成する帯の数です

境界ゆらぎ
jitter
Float
60–64 / step 0.5

境界をどれだけゆらすかです

周波数
frequency
Float
20.25–16 / step 0.25

大きいほど細かく境界が揺れます

シード
seed
Int
10–99999

帯のゆらぎを再現するためのシードです

左右ループ
wrap_x
Bool
false

左右の端がつながっているものとして生成します

上下ループ
wrap_y
Bool
false

上下の端がつながっているものとして生成します

ID順
id_order
Enum
SeedOrder

生成した領域IDの並べ替え方法です

  • 生成順SeedOrder
    生成時のID順を使います
  • 左上からTopLeft
    外接矩形の上端、次に左端の昇順で小さいIDを割り当てます
  • 右下からBottomRight
    外接矩形の下端、次に右端の降順で小さいIDを割り当てます
  • 面積昇順AreaAsc
    面積が小さい領域から小さいIDを割り当てます
  • 面積降順AreaDesc
    面積が大きい領域から小さいIDを割り当てます
ID表示
show_ids
Bool
false

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

Overview

Generates regions by dividing the canvas into directional bands. Use it to create regular flowing surfaces such as depth levels in water, a sunset sky, or terrain height layers. For cracks and disruptions, use its sibling region_strata.

Usage tips

  • The go-to background recipe is region_bands(Horizontal, band_count=4–8)region_fill with a gradient-like sequence of colors. This separates water depth, sky, or strata into colored levels.
  • Control boundary variation with jitter and frequency. With jitter=0 the bands are ruler-straight; increasing it creates more natural waves. Frequency controls how fine those waves are.
  • Diagonal directions (DiagonalDown / DiagonalUp) also work for light rays, rain, and a sense of speed.

Related nodes

  • region_strata — strata with cracks and separations
  • region_fill — assign colors to bands
  • region_border / region_boundary_trace — extract boundaries
  • region_warp — distort the entire set of bands

Directly generates a banded RegionMap at the final size in horizontal, vertical, or diagonal directions. It is suited to strata, water depth, steps, and directional surface divisions in backgrounds.

Key parameters

ID Description
width / height Pixel dimensions of the RegionMap
direction Horizontal / Vertical / DiagonalDown / DiagonalUp
band_count Number of bands
jitter Amount of boundary variation
frequency Fineness of boundary variation
wrap_x / wrap_y Treat as looping horizontally / vertically
id_order How IDs are reordered after generation

How to use

  1. Set width / height to match the final image.
  2. Choose direction to match the terrain or water-depth flow.
  3. Adjust band_count and jitter, then connect to Region Merge Small or Region Boundary Trace if needed.

When mask is connected, bands are generated only inside the active mask area and the outside is treated as OUTSIDE. Pixels where lightness * alpha >= 0.5 are active. An arbitrary mask shape takes priority, so wrap_x / wrap_y are disabled in the output while a mask is connected.

This node creates more regular bands than Region Strata. Use it when water depth, terrain height steps, or background direction should make the surface flow easy to read. Use Region Strata when you need rocky cracks or interruptions partway through.

Back to Node List
Region Bands — PixPipeline Node Reference