Merge
Brief Description
Blends the source image with another image. This is the same operation that is done when blending a layer in a Composition.
Controls
| Parameter / Script Name | Type | Default | Function |
|---|---|---|---|
Enabled / enabled
|
Boolean | On | |
Red / process_red
|
Boolean | On | Enable the red channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Green / process_green
|
Boolean | On | Enable the green channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Blue / process_blue
|
Boolean | On | Enable the blue channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Alpha / process_alpha
|
Boolean | On | Enable the alpha channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Foreground / foreground
|
Image | - | |
Mode / mode
|
Choice | Normal |
Add: Ac + Dc — The source is added to the destination and replaces the destination. Color Dodge: if Ac < 1 → min(1, Bc / (1 - Ac)); else 1 — Brightens the backdrop color. Lighten: max(Ac, Bc) — Result is the lighter of source or destination. Linear Dodge: min(Ac + Bc, 1) — Lightens image. Screen: Ac + Bc - Ac * Bc — Always lightens. Hard-light: multiply or screen depending on Ac. Hard Mix: if vivid-light(Ac,Bc) < 0.5 then 0 else 1 Linear Light: linear-burn or linear-dodge depending on Ac. Overlay: multiply or screen depending on Bc. Pin Light: mix of lighten/darken; removes mid-tones. Soft Light: complex formula using Bc and Ac. Vivid Light: color burn/dodge. Difference: abs(A - B). Divide: if Dc > 0 and Ac > 0 → Ac / Bc; else 0. Exclusion: Ac + Bc - 2 * Ac * Bc. Minus: Ac - Bc. Subtract: Bc - Ac. Color: SetLum(Ac, Lum(Bc)). Hue: SetLum(SetSat(Ac, Sat(Bc)), Lum(Bc)). Luminosity: SetLum(Bc, Lum(Ac)). Saturation: SetLum(SetSat(Bc, Sat(Ac)), Lum(Bc)). Replace: Ac. Destination Atop: Bca × Aa + Aca × (1 - Ba). Destination Out: Ba * Bc * (1 - Aa). Destination Over: Aa * (1 - Ba) + Bc. Destination In: Bc * Aa. Source Atop: Ac * Ba + Bc * (1 - Aa). Source Out: Ac * (1 - Ba). Normal: Ac + Bc * (1 - Aa). Source In: Ac * Ba. Xor: Ac * (1 - Ba) + Bc * (1 - Aa). Average: (Ac + Bc) / 2. Conjoint Over: depends on Aa and Ba. Disjoint Over: depends on Aa + Ba. Geometric: 2 * Ac * Bc / (Ac + Bc). Grain Extract: Bc - Ac + 0.5. Grain Merge: Bc + Ac - 0.5. Hypot: sqrt(Ac² + Bc²). Reflect: Aa² / (1 - Ba). Color Burn: darken based on Ac. Darken: min(Ac, Bc). Linear Burn: Bc + Ac - 1. Multiply: Ac * Bc. Multiply (Math): Ac * Bc (negative values preserved). |
Mask alpha / use_alpha_screen
|
Boolean | On | When checked, alpha is processed using screen blending. Enabled only where it makes sense. |
Bounding Box / rod_type
|
Choice | Union | Union
Intersection Foreground Original |
Source Mode / inputMode
|
Choice | Foreground |
Whether the extra image source is the foreground or background: Foreground Background |
Mask / mask
|
Image | - | |
Mix / mix_with_source
|
Float | 1 | Dissolves between original image (0) and effect-applied image (1). |