Key
Remove a colour background with a chroma key.
What it does
Key pulls a transparency matte by comparing every pixel against a reference, a key colour, a brightness level, or a clean background plate, and turning matching pixels transparent. It covers green-screen and blue-screen work, brightness keys, and difference keys against a locked-off empty background.
Five modes: Chroma and Chroma (Video) key out a specific hue, Luma keys out shadows or highlights, Color keys out an exact colour by distance, and Difference compares against a Clean Plate to key out anything that has not changed. Tolerance and Softness set how tight the key is and how soft its edge falls off. Despill cleans colour spill from the screen onto the subject's edges.
When to use it
Green-screen or blue-screen cutouts: Chroma, or Chroma (Video).
Noisy or compressed footage where a plain Chroma key tears: Chroma (Video), tuned for video colour-difference keying.
Keying out shadows or blown highlights rather than a colour: Luma.
A locked-off shot of the empty background available: wire it into Clean Plate and use Difference.
Green or blue fringing on the subject: raise Despill.
A matte with holes, fringing or jagged edges: enable Edge Refinement and use Erode, Dilate and Blur.
| Parameter | Type | Default |
|---|---|---|
content_in | OneOf([FieldOf(Raster)]) | — |
clean_plate | OneOf([FieldOf(Raster)]) | — |
depth_in | OneOf([FieldOf(Raster)]) | — |
object_id_in | OneOf([FieldOf(Raster)]) | — |
mode | String | "Chroma" |
target_object | String | "" |
antialiased | Boolean | false |
key_color | Color | rgba(0.00, 1.00, 0.00, 1.00) |
tolerance | Number | 0.200 |
softness | Number | 0.100 |
depth_near | Number | 0 |
depth_far | Number | 1 |
clip_black | Number | 0 |
clip_white | Number | 1 |
invert | Boolean | false |
despill | Number | 0.500 |
despill_method | String | "Average" |
luma_target | String | "Dark" |
edge_refine | Boolean | false |
erode | Number | 0 |
dilate | Number | 0 |
edge_blur | Number | 0 |
output_mode | String | "Keyed" |
spatial_strength | Field | — |
strength | Number | 1 |
Gotchas
Despill acts only when Key Color is a green or blue hue. With a red, yellow or other off-hue key colour the Despill slider stays visible and has no visible effect: spill suppression is built around the green and blue screen case.
Difference mode needs a Clean Plate wired in, an empty background plate shot from the same locked-off camera position. Without one there is nothing to compare against and the key does not work.
Edge Refinement (Erode, Dilate, Blur) affects the alpha edge only, so it does nothing when Output Mode is set to Matte, which is fixed fully opaque for preview. Switch back to Keyed to see refinement take effect.
Worked example
Add a Key node and wire green-screen footage into Content In.
Leave Mode on Chroma and set Key Color by sampling the screen colour.
Raise Tolerance until the background disappears, then raise Softness slightly to smooth the cutout edge.
If a green fringe shows around the subject, raise Despill.
If the matte has small holes or ragged edges, enable Edge Refinement and adjust Erode, Dilate and Blur to clean it up.