Nodes · Atelier

BS_Advect

Atelierv1coreNeeds full inputForge

Overview

Carries a texture or painted layer along the picture's motion: regenerated at keys and cross-faded by distortion (watercolour grain and washes that move with the shot), or each painted frame's strokes carried both ways up to a horizon (paint that smears off the surface). Uses the render's vectors or MotionVectors; solves flow itself when there are none, and says so.

How to

How-to

Wire the plate (with a motion pass when it has one) and the texture or paint you want carried along.
Set keys — the frames the texture is regenerated on — and period; between keys the texture is advected from both ends and cross-faded.
solve_flow when the stream has no motion pass; the node says which it used.
strokes mode carries paint keys to a horizon without cross-fade — the Atelier's advected anchor.
⚒ Bake frames when the look is settled; a moved knob makes the bake ⚠ stale.

Inputs

Input	What it takes
in	the image this node works on
texture	—

Outputs

Output	Type
out	Image

Parameters

Parameter	Type	Default	What it does
mode	Choice	texture	texture: regenerate at keys every `period` frames and cross-fade the two nearest keys' carried textures by distortion (watercolour grain, washes). strokes: carry each key frame's paint both ways up to `horizon`, no cross-fade (the Advected anchor space). `texturestrokes`
keys	Text		The key frames (comma-separated). texture mode: empty = periodic from `start`. strokes mode: the frames the paint was made on.
period	Int	12	Frames between regeneration keys in texture mode.
start	Float	0.0	The first periodic key.
horizon	Int	12	How many frames a key's paint is carried each way in strokes mode.
motion_layer	Text	auto	The forward motion pass (auto finds motion / velocity / MotionVectors).
motion_scale	Float	1.0	Scale on the motion vectors (a render's vectors are sometimes half or double).
solve_flow	Choice	on	With no motion pass, solve optical flow per frame pair inside the node — slower, estimated, and said on the node. `onoff`
distortion_limit	Float	1.0	Carried texture fades as its map's stretch, shear or fold passes this (Bousseau's distortion weight).
output	Choice	composite	composite: the carried layer over the stream. advected: the carried layer alone. distortion: the accumulated distortion, to look at. `compositeadvecteddistortion`
baked	Text		The frames ⚒ Bake frames wrote; read instead of computed while set.
baked_hash	Text		The look fingerprint the bake was made from.
status	Text		What the last solve did: the motion source it used (the stream's pass or Lucas–Kanade), the keys it advected between, and any refusal.
disabled	Bool	false	Bypass: the node passes its first input through untouched (D in the graph). The knobs keep their values for when it comes back.
label	Text		A note shown under the node in the graph — what this node is FOR. Never affects the render or the cache.
hide_input	Bool	false	Draw the node without its input wire — a tidy graph for a node whose source is obvious (a Dot, a viewer tap).