Back to Node List

Region Warp

region_warp

Warps RegionMap boundaries with procedural noise or an image guide

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 です
ガイド
guide
Image
画像方式で歪み方向に使う任意の画像です

Output Ports

NameTypeDescription
領域
regions
RegionMap
歪ませた RegionMap です
プレビュー
preview
Image
歪ませた領域の色分け確認用画像です
ラベル
labels
Map
Inspector に重ねるIDラベル位置です

Parameters

NameTypeDefaultRangeDescription / Options
歪み元
source
Enum
Noise

歪みに使う入力です

  • ノイズNoise
    内部ノイズで歪ませます
  • 画像Image
    ガイド画像の明度で歪ませます
amount
Int
30–32

最大で何ピクセルずらすかです

スケール
scale
Float
161–128 / step 1

ノイズの大きさです

反復
iterations
Int
11–8

歪みを繰り返す回数です

シード
seed
Int
10–99999

ノイズとプレビュー色に使うシードです

ID表示
show_ids
Bool
false

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

Overview

Adds a hand-drawn feel by perturbing RegionMap boundaries with noise. Generated regions tend to have geometric boundaries; even a slight distortion greatly improves the natural appearance of rock, soil, and water.

It distorts RegionMap boundaries with internal noise or a guide image. Use it to add natural variation to overly regular cells and strata.

Usage tips

  • Place it immediately after generation: region_bands / region_cells → region_warp → region_fill. Start with a restrained displacement of 2–4 pixels.
  • Strong distortion can break thin regions apart. If that happens, clean them up downstream with region_merge_small.
  • Guide Image mode is an advanced option for controlling the distortion direction. Internal Noise is sufficient in most cases.

Related nodes

  • region_bands / region_cells / region_strata — sources to distort
  • region_merge_small — cleans up after distortion
  • region_fill / region_border — finishing fill and lines

Key parameters

ID Contents
source Noise uses internal noise; Image distorts using brightness differences in the guide image
amount Maximum displacement in pixels
scale Noise size
iterations Number of distortion passes
seed Seed for noise and preview colors
show_ids Display ID labels in the Inspector preview

Horizontal and vertical wrapping on the RegionMap are preserved. In a wrapped direction, references across the edge also wrap around.

How to use

Insert this after Region Cells or Region Bands when the boundaries look too regular. Start with a small amount, then increase iterations if needed. Strong settings easily damage thin regions and small islands, so a downstream Region Merge Small makes the result easier to handle.

With source = Image, brightness differences in the guide input inform the distortion direction. When no guide is needed, source = Noise is the stable choice.

When source = Image and guide is unconnected, the node returns the RegionMap unchanged and displays a warning. Connect a guide or switch back to Noise to clear the warning.

This node edits regions to introduce natural variation. To increase the number of regions, use an upstream generator or Region Split Islands / Region Compose.

Back to Node List
Region Warp — PixPipeline Node Reference