Skip to content

Nodes · Keying

BS_EdgeExtend

Keyingv1coreNeeds full inputForge

Overview

Pushes edge colour outward smoothly — as far as you like, up to filling the whole frame. Blacksmith's answer to the dilate-based extends that streak and die after a few dozen pixels. Use before a defocus (so it drags colour, not black), to fill depth-pass holes, or to extend despilled edge colour. Alpha is never touched.

How to

How-to

  1. Wire the element; the edge comes from its alpha, or the matte input with matte_source = matte.
  2. distance pushes colour out that many pixels; fill frame extends to the whole frame for a clean plate behind a key.
  3. pre_erode throws away a contaminated fringe first; stability stops shimmer on a still plate.

Inputs

InputWhat it takes
inthe image this node works on
mattethe alpha that drives this node

Outputs

OutputType
outImage

Parameters

ParameterTypeDefaultWhat it does
modeChoicedistancedistance pushes the edge colour out by distance pixels; fill frame extends it to the whole frame — the data window grows with it. distancefill frame
distanceFloat64.0How far past the edge the colour is extended, pixels.
pre_erodeFloat0.0Erode the matte by this many pixels before extending, so a contaminated fringe is thrown away and clean interior colour is what gets pulled out.
qualityFloat4.0How many refinement passes the extension runs — higher is smoother far from the edge and slower.
stabilityBoolfalseDamp frame-to-frame change in the extended colour so a still plate does not shimmer past its edge.
matte_sourceChoicealphaWhat defines the edge: the input's own alpha, or the wired matte input. alphamatte
disabledBoolfalseBypass: the node passes its first input through untouched (D in the graph). The knobs keep their values for when it comes back.
labelTextA note shown under the node in the graph — what this node is FOR. Never affects the render or the cache.
hide_inputBoolfalseDraw the node without its input wire — a tidy graph for a node whose source is obvious (a Dot, a viewer tap).

See also