
ANR AI Matte Propagator
Paint or roto the matte on one frame, press Start Propagation, and the AI model carries that matte through the rest of the shot.
- Masking
- Masking pack
- Masking models
- 2 inputs
- 9 controls
Overview
AI Matte Propagator takes a matte you made on one frame, the Init Frame, and follows the subject with it through the shot, forward and backward from that frame. The matte can come from anything: a roto, a paint stroke, a key, or a frame of ANR Matte Creator.
Nothing runs until you press Start Propagation. The node then reads your mask on the Init Frame and the plate around it, and every frame you play or render gets its own matte.
The result is the raw propagated matte: soft (Raw Soft) or cut to black and white (Raw Hard). To refine hair and soft edges afterwards, follow it with ANR AI Matte Perfector.
Inputs
- Sourcerequired
The plate the subject moves in. The AI follows the subject through its pictures.
- Maskrequired
Your matte (its alpha). Only the Init Frame is read, so it only needs to be right on that frame.
Output. The Source with the propagated matte in alpha. Display sets the RGB: the picture tinted with the matte (Matte Overlay, the default), the matte in black and white, the picture premultiplied, or the picture untouched.
Quick start
- Draw your matte on one frame with a Roto (or any matte) and connect it to Mask. Connect the plate to Source.
- Go to that frame and press Set to Current Frame, or type it into Init Frame.
- Press Start Propagation. The Status line confirms the frame it started from.
- Play or render the shot. Check the matte with Display on Matte Overlay.
- For the comp, set Display to Straight (RGB + alpha) or Premultiplied, or take the alpha from the node.
The panel
The node's panel as Nuke shows it, with the values of a new node. Click any control to see what it does; tabs and sections work as in Nuke.
No control matches.
All controls
ANR AI Matte Propagator9 controls
- StatusStatus
status What the node is doing, or what it needs next: connect the inputs, choose the Init Frame, press Start Propagation.
- Init FrameSlider
initFrame Frame containing your painted Mask. Propagation begins only after Start Propagation is pressed.
- Set to Current FrameButton
setInitToCurrent Use the current timeline frame as the seed frame.
- Start PropagationButton
startPropagation Load Cutie and propagate the connected Mask from Init Frame. Nothing runs before this is pressed.
- Go to Init FrameButton
goToInit Jump the timeline to the init frame.
- OutputMenu
refiner Raw Soft preserves Cutie probabilities. Raw Hard thresholds them into a binary matte.
- DisplayMenu
display 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.
- Overlay OpacitySlider
overlayMix How strongly each object is tinted in Matte Overlay.
- Processing ResolutionSlider
processingResolution Maximum long edge in pixels used by Cutie. Preserves aspect ratio and never enlarges the source. 1920 is a practical starting point; 2560 or 3840 retain more detail on larger plates but use more GPU memory and time. After changing it, press Start Propagation again. Init Frame and subsequent frames show the same Cutie prediction pipeline.
Tips
- Choose an Init Frame where the subject is fully in view and clearly separated from the background: the AI starts from exactly what you painted there.
- On large plates, raise Processing Resolution to 2560 or 3840 to keep more edge detail; it uses more graphics memory and time.
- Output > Raw Hard gives a clean black-and-white matte for garbage mattes and holdouts; Raw Soft keeps the AI model's soft transitions.
- Connect the result to ANR AI Matte Perfector's Mask input to rebuild hair and motion blur at full resolution.
Good to know
- Changing Init Frame, Processing Resolution or either input stops the propagation: press Start Propagation again.
- Start Propagation refuses when the Mask is empty on the Init Frame. Paint the matte first.
- The node needs an NVIDIA graphics card for practical speeds.
- If the Masking models were not installed with ANR Tools, Nuke offers to download them the first time you add the node in a session (Download models or Not now). After the download, press Start Propagation again.
- After about ten minutes without work (sooner when the graphics card is nearly full), the node gives its graphics memory back. The next frame loads the model again, which takes a moment.
- This node does not bake to disk. To freeze the result, render it out with a Write node, or follow it with ANR AI Matte Perfector and bake there.
Something unclear or missing? Write to [email protected].