Back to Node List

Edge Detect

edge_detect

Finds borders where brightness, transparency, or color changes sharply.

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
画像
input
Image
Required
輪郭や色の変わり目を取り出したい画像です。

Output Ports

NameTypeDescription
エッジ
output
Image
白黒のエッジ画像です。白いほど強い境界です。

Parameters

NameTypeDefaultRangeDescription / Options
検出基準
mode
Enum
OKLCH-L

何の変化を線として取り出すかです。形の輪郭なら Alpha、見た目の明暗なら OKLCH 明度を使います。

  • OKLCH 明度OKLCH-L
    見た目の明るさが変わる場所を探します。自然な輪郭抽出に向いています。
  • 輝度Luminance
    RGB から作った白黒の明るさで境界を探します。
  • アルファAlpha
    透明/不透明の境界を探します。シルエットの輪郭に向いています。
  • RGB 差分RGB-Difference
    RGB の色が変わる場所を探します。色の差を直接見たい時に使います。
  • OKLCH 差分OKLCH-Difference
    見た目の色が変わる場所を探します。RGB では拾いにくい色差を見たい時に使います。
強さ
strength
Float
20–8 / step 0.05

検出した線の濃さです。上げるほど線が白く強く出ます。

しきい値
threshold
Float
00–1 / step 0.01

弱い線を消します。上げるほど強い境界だけが残ります。

反転
invert
Bool
false

結果の白黒を反転します。白地に黒線が欲しい時に使います。

左右ループ
wrap_x
Bool
false

左右の端がつながっているものとして隣のピクセルと比べます。タイル素材向けです。

上下ループ
wrap_y
Bool
false

上下の端がつながっているものとして隣のピクセルと比べます。タイル素材向けです。

Overview

Extracts abrupt changes in an image as white lines. Use it as the basis for an outline, a boundary mask, a glowing edge, or surface-relief effects.

Select with mode whether to detect changes in brightness, boundaries in alpha, or changes in the colors themselves.

Usage tips

  • Choosing mode is the key: use Alpha for a shape's outline (the boundary with transparency), or OKLCH-L for light-dark boundaries inside the artwork. When unsure, start with Alpha.
  • The output is not a line image but a map of boundary strength. To use it as a line, remove noise with threshold and layer it with blend, or pass it as a mask to a color-adjustment node.
  • strength accepts 0–8 and threshold accepts 0–1. Values promoted from input ports outside those ranges are clamped, with a warning shown on the parameter.
  • For a character silhouette, the dedicated outline node is more direct. Use Edge Detect when you also want to capture boundaries inside the image.

Related nodes

  • outline — dedicated silhouette-outline node
  • blend — layer the detected lines
  • morphology — thicken and clean up the detected result
  • region_border — RegionMap-based boundaries

Examples

  • Use Alpha to extract the boundary with transparent areas as the basis for an outline.
  • Use OKLCH-L to turn only light-dark boundaries into white lines.
  • Raise threshold to remove fine grain and retain only strong outlines.
  • For tile assets, enable wrap_x / wrap_y so edge detection includes continuity across the left/right and top/bottom edges.
Back to Node List
Edge Detect — PixPipeline Node Reference