ANR AI Matte Perfector

StatusStatusstatus

What the node is doing, or what it needs: a matte on Mask, or an RGBA Source with an alpha.

Freeze and Bake to DiskCheckboxbake

Write every frame that renders as a 16-bit RGBA PNG (the matte in rgb and alpha) and play them back from disk. With this on, opening the comp starts no AI engine and uses no graphics memory. Turn it off to re-render.

Default: off

Import Baked FootageButtonimportBaked

Creates a Read node for the baked sequence right under this node (through Nuke's own Python). If the host cannot do that, the Read goes on the clipboard instead: hover the node graph and press Ctrl+V.

Bake Settings

Generate AutofillButtonanrCacheAutoFill

Create a new node-type/footage_letter_4digits folder on every click, then stop. Previous caches are kept. Enter a folder to choose a custom base.

Makes a new, empty folder for this node each time you click it and puts it in Cache Folder. It goes next to the saved script by default (ANR > Cache Folders > Location in Nuke's menu bar can put it next to the footage); a folder you typed into Cache Folder is used as the base instead. Save the script first.

Cache FolderFilebakeDir

Each node writes //.####.png. Read the sequence back with an ordinary Read node.

Each node writes into a subfolder named after Name Prefix: with the default prefix, anr_matte/anr_matte.####.png inside this folder. Two nodes with the same folder and prefix write over each other, so give each node its own folder (Generate Autofill does) or its own prefix.

Default: empty

Name PrefixTextbakePrefix

Prefix for the subfolder and the file names; #### sets the frame padding. Empty uses the node's own id.

Default: anr_matte.####

Limit to Frame RangeCheckboxbakeRange

Only bake (and matte) frames inside the range below; the rest pass through. Off: Bake Frames bakes the Source's whole range.

Default: off

Bake FromSliderbakeFrom

First frame to bake.

Default: 1

Bake ToSliderbakeTo

Last frame to bake.

Default: 100

Bake FramesButtonbakeFrames

Bake now, without playing through the shot: every frame from Bake From to Bake To when Limit to Frame Range is on, otherwise the Source's whole range. Each frame is matted again and written as a 16-bit RGBA PNG (the matte in rgb and alpha) into the Cache Folder; Freeze and Bake to Disk turns on, so they play back from disk. Cancel on the progress bar stops it.

Edge RefinerMenurefiner

Raw: the soft mask straight from the tracker, shaped by Edge Softness. Hard: thresholded, no refiner. MEMatte / ViTMatte: AI edge matting for hair, fur and soft edges -- the best quality, a little slower. MEMatte is lighter on a 4K plate.

This node offers only the two matting models; the tooltip's Raw and Hard choices belong to ANR Matte Creator.

Default: ViTMatteOptions: ViTMatte MEMatte

Edge StabilitySlideredgeStability

Reduce flicker using motion-aligned neighbouring frames. 0 is off. Higher values use more temporal averaging. Rejects unreliable motion and large changes; requires additional frame processing.

Default: 0

Binarize ThresholdSliderbinarize

Where the tracker's probability is cut into foreground and background. Drives Hard output, the centre of the refiner's band, and the cleanup. SAM's own midpoint is 0.5, but that sits about 2 pixels inside the edge a commercial matte draws on a 4K plate; 0.3 matched it. Lower is bigger.

Here the threshold cuts your input matte: pixels above it are inside the subject, and the refine band is centred on that cut.

Default: 0.3

Refine Band InsideSlidertrimapErode

How far inside the edge is definitely foreground, in pixels. Small keeps the edge where the tracker put it; large lets the refiner move it further inward.

Default: 6

Refine Band OutsideSlidertrimapDilate

How far outside the edge the refiner may grow detail, in pixels. The main quality knob: 8 for a clean cloth or skin edge, 30 or more for long wispy hair. Wider is softer, and slower.

Default: 20

Edge SmoothingSlideredgeSmooth

Rounds the edge, in pixels. With a matting model it is a blur applied only inside the refiner's band, removing the model's grain; with Hard or Raw output it rounds the cut through the scaled-up tracker probability. 1.5 matches a clean commercial matte; 0 is off.

Default: 1.5

DisplayMenudisplay

Matte Overlay: the picture with each object tinted, alpha carries the matte. Matte Only: black and white. Premultiplied: the picture cut out by the matte. Straight: the picture untouched with the matte in alpha.

Default: Straight (RGB + alpha)Options: Matte Overlay Matte Only Premultiplied Straight (RGB + alpha)

Overlay OpacitySlideroverlayMix

How strongly each object is tinted in Matte Overlay.

Default: 0.5

Cleanup

Close GapsSlidercloseGaps

Smooth the tracked mask before it is cut: creases, notches and thin slits narrower than this many pixels are closed, so the edge does not chase a shadow between an arm and the body. 0 is off. It also closes real gaps of that size (between fingers), so keep it small.

Default: 0

Fill Holes Before RefineCheckboxrefineFillHoles

Close every enclosed hole in the hard matte before it goes to the matting model, so the refiner only solves the outer edge. Off when the subject has real gaps (between an arm and the body).

Default: off

Remove SprinklesSliderremoveSprinkles

Drop disconnected islands up to this area, in full-resolution pixels. 0 is off.

Default: 0

Fill HolesSliderfillHoles

Fill enclosed holes up to this area, in pixels. 0 is off.

Default: 0

Shrink / GrowSlidershrinkGrow

Contract (negative) or expand (positive) the matte, in pixels.

Default: 0

FeatherSliderfeather

Soften the matte edge with a blur, in pixels.

Default: 0

Holdout ModeMenuholdoutMode

How the Holdout input is applied to the finished matte. Add is a union, Subtract cuts it out, Intersect keeps only the overlap.

Default: AddOptions: Off Add Subtract Intersect

Edge (expert)

Solve Uncertain AreasCheckboxtrimapAdaptive

Where the tracker itself is unsure (fingers, hair, thin edges: probabilities well away from 0 and 1), no Binarize Threshold is right, so those pixels go to the matting model instead of being cut. Where the tracker is sure, the threshold and the trimap band apply as usual.

Default: on

Solve Existing Soft EdgeCheckboxtrimapSoft

Pixels that are already partly transparent (a keyer, a blurred roto, a soft mask input) join the uncertain band as well.

Default: on

Edge ContrastSlideredgeContrast

Tighten the refined edge. 1 keeps the matting model's answer, including motion blur and hair; 2 halves the width of every transition and also hardens motion blur, so use it only on a sharp, static edge that came out soft.

Default: 1

Trimap Pre-BlurSlidertrimapPreblur

Smooth the mask before building the trimap, to soften the upscale staircase.

Default: 0

Show TrimapCheckboxshowTrimap

Paint the trimap in the viewer: green inside, cyan outside, grey the band the refiner solves. View only.

Shows only when Display is Matte Overlay.

Default: off

Refiner Tile SizeSlidertileSize

How much of the edge goes to the matting model at a time, in pixels. The edge is never reduced: a bigger subject is more tiles. Lower this if you run out of graphics memory.

Default: 1536

Levels

Input BlackSliderinBlack

Shape the raw soft mask before it is cut: black, white and gamma.

Default: 0

Input WhiteSliderinWhite

Shape the raw soft mask before it is cut: black, white and gamma.

Default: 1

Input GammaSliderinGamma

Shape the raw soft mask before it is cut: black, white and gamma.

Default: 1

Output BlackSlideroutBlack

Remap the finished matte. A white point of 0.99 snaps a nearly solid interior to a clean 1.0.

Default: 0

Output WhiteSlideroutWhite

Remap the finished matte. A white point of 0.99 snaps a nearly solid interior to a clean 1.0.

Default: 1

Output GammaSlideroutGamma

Remap the finished matte. A white point of 0.99 snaps a nearly solid interior to a clean 1.0.

Default: 1

System

DeviceMenudevice

Automatic uses the GPU and compiles the encoder for it once (about a minute the first time). GPU skips the compile. CPU is many times slower and only for machines without an NVIDIA card.

Default: Automatic (GPU, compiled)Options: Automatic (GPU, compiled) GPU CPU

Apply sRGB to InputCheckboxsrgbInput

The models were trained on display-referred pictures. On, for a linear working space (Nuke's default): the plate is converted to sRGB before the model sees it. Off when the input is already display-referred or you colour-manage upstream. Only the picture the AI sees changes.

Default: on

Mask Cache (MB)SlidercacheBudget

How much memory tracked masks may take per node before the oldest are dropped. Bake to disk for long shots.

Default: 768

Load ModelsButtonloadModel

Start the inference helper and load SAM 3 now. Otherwise it happens on the first render.

Loads the matting model chosen in Edge Refiner ahead of the first render. This node loads no tracking model.

UnloadButtonunloadModel

Stop the helper and give every byte of graphics memory back.