Merge
Layers the A input with the B input using the chosen operation (30 operations, over by default).
Layers the A input with the B input using the chosen operation (30 operations, over by default). Connect A to the spare input to add A2, A3 and more; each one is merged onto the result in order. Video colorspace does the maths in sRGB. alpha masking only applies to the blend operations. set bbox to picks the size of the result; range from and metadata from are kept for .nk files only.
| Node | Merge |
|---|---|
| Menu | Merge › Merge |
| Names in each format | |
| .oink comp (JSON) | "type": "OC_N_merge" |
| .nk script | Merge2, also imports Merge (how .nk import works) |
| Python | nuke.createNode("OC_N_merge") |
| Assistant (MCP) | create_node(type="OC_N_merge") |
| Tab search | merge |
Inputs and outputs
| Port | Name | Type |
|---|---|---|
| input 0 | B | image |
| input 1 | A | image |
| input 2 | mask | image |
| output 0 | Image | image |
Knobs
Panel tab Merge, in panel order.
| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
operation | operation | menu | over | atop, average, color-burn, color-dodge, conjoint-over, copy, difference, disjoint-over, divide, exclusion, from, geometric, hard-light, hypot, in, mask, matte, max, min, minus, multiply, out, over, overlay, plus, screen, soft-light, sten... | operation | |
sRGB | Video colorspace | bool | false | sRGB | Merge in sRGB (the 8-bit colorspace), then back to linear | |
alpha_masking | alpha masking | bool | false | screen_alpha | ||
bbox | set bbox to | menu | union | union, intersection, A, B | bbox | |
metadata_from | metadata from | menu | B | B, A, All | metainput | |
range_from | range from | menu | B | B, A, All | rangeinput | |
a_channels | A channels | text | rgba | Achannels | Layer taken from A ('none' = black); its alpha is a | |
b_channels | B channels | text | rgba | Bchannels | Layer taken from B ('none' = black); its alpha is b | |
output | output | text | rgba | output | Layer written: rgba, rgb, alpha or any layer name | |
also_merge | also merge | text | none | also_merge | Extra layer merged with the same operation | |
mask_channel | mask | menu | none | none, rgba.alpha, rgba.red, rgba.green, rgba.blue | Mask channel, e.g. rgba.alpha (none = no mask; a linked mask input then uses rgba.alpha) | |
invert_mask | invert | bool | false | invert_mask | ||
mix | mix | float | 1 | 0 to 1 | mix |
Other knobs (Python, .nk and the assistant; not on the panel)
| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
gl_color | Viewer Controls Color | float ×3 | 0, 0, 0 | 0 to 1 | ||
postage_stamp_frame | Static Frame | int | 1 | -2147483648 to 2147483647 | ||
lifetimeStart | Lifetime Start | int | 0 | -2147483648 to 2147483647 | ||
lifetimeEnd | Lifetime End | int | 100 | -2147483648 to 2147483647 | ||
useLifetime | Use Lifetime | boolean | false | |||
cached | Cached | boolean | false | |||
bookmark | Bookmark | boolean | false | |||
dope_sheet | Dope Sheet | boolean | false | |||
clone_group | Clone Group | string | ||||
link_source | Link Source | string | ||||
link_overrides | Link Overrides | string | ||||
split_views | Split Views | string | ||||
mode | Mode | enum | NONE | NONE, PLUS, MULTIPLY, SCREEN |
Knob names in .nk scripts
| .nk knob | Knob here |
|---|---|
Achannels | a_channels |
Bchannels | b_channels |
metainput | metadata_from |
rangeinput | range_from |
screen_alpha | alpha_masking |
Other .nk knobs use the same name here. See .nk import.
Examples
Open these from Help › Examples…, or from the ? menu in this node's Properties panel.
- Greenscreen: ScreenKey, Despill, comp over a sky (
examples/keying/greenscreen_key_despill.oink): Tears of Steel plate 08_3a (CC BY 3.0, Blender Foundation, mango.blender.org): an actor on a green screen that falls off towards the frame edges. ScreenKey pulls the key from a screen colour picked over the open screen (Ctrl+click or Ctrl+Shift+drag in the Viewer with its panel open), with screen gain 1.1 and clip black / white 0.1 / 0.9 for the uneven screen; its own despill is off so the Despill node (average) does it. The premultiplied result goes over a Poly Haven sky (CC0) reformatted to the plate. The same chain ships as the Keying ToolSet. - Merge operations: multiply, screen, plus (
examples/merge/merge_operations.oink): Three Merges on the same A and B: multiply (darkens), screen (lightens), plus (adds light). The Switch picks which one the Viewer sees; change its "which" knob to compare. - Merge over (
examples/merge/merge_over.oink): A premultiplied CG render (CandleGlass, alpha 0 with non-zero rgb in places) scaled down and merged over a photo with Merge (over): A over B = A + B * (1 - A.alpha). - CornerPin a photo onto a plate (
examples/transform/cornerpin.oink): CornerPin maps the four corners of the source (from1-4) to four points (to1-4). The pinned photo is merged over another plate, like a screen replacement.