Forged/Docs/Forged ImageProducts ↗

Nodes · Masks

BS_MotionMatte

Masksv2coreTempered

Overview

The camera tracker's subject detector, standing alone: mattes of everything moving independently of the camera, as matte and matteId channels for garbage mattes, holdouts and per-subject grades.

How to

Press ⚒ Analyze to track the shot and find the movers.
Use matte downstream as coverage, matteId to pick one subject.

Inputs

Input	What it takes
in	the image this node works on

Outputs

Output	Type
out	Image

Parameters

Parameter	Type	Default	What it does
mattes	Text		The forged MatteSet (JSON), baked by ⚒ Analyze. The kernel rasterizes it into matte / matteId every frame.
matte_start	Float	0.0	The project frame the baked mattes start at — set by ⚒ Analyze.
feather	Float	8.0	Soft-edge width of the rasterized matte, in pixels — the falloff outside each silhouette. Raster-time softening only: it cannot tighten the matte's shape. If the matte is the wrong SHAPE, that's the Detail knob.
holdout_regions	Text		Regions the analysis ignores, drawn in the viewer — a mirror, a screen showing motion.
matte_ignore	Text		Detected subjects the artist marked IGNORE: they are dropped from the output mattes.
matte_accept	Text		Detected subjects the artist marked ACCEPT: they render even below the confidence the analysis would have cut.
status	Text		What the last ⚒ Analyze did: frames, subjects found, and any refusal.
detail	Choice	normal	Analysis grid resolution — the matte's own resolution, and the only control that changes the SHAPE. The boundary is decided one grid cell at a time, so the cell size is the floor on how closely it can follow an edge. Cost is quadratic: at 1080p, Coarse is a 16px grid (~0.3× the time), Normal 9px, Fine 6px (~2.25×). On a 60-frame 1080p plate Normal is around two minutes and Fine four to five, so reach for Fine on the shot that needs it rather than by default. Re-run ⚒ Analyze after changing it. (Feather softens the rasterized edge afterwards — it cannot tighten geometry.) `coarsenormalfine`
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).

See also

The Blacksmith family — Tools that do a whole job instead of a whole operation.