Light-wrap

Brief Description

Useful to composite objects into a background by spilling light from the background on the edges of the foreground objects.

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 main source content is returned, else 0.
Blue / process_blue Boolean On Enable the blue channel in output. Otherwise if there's a source the main source content is returned, else 0.
Alpha / process_alpha Boolean On Enable the alpha channel in output. Otherwise if there's a source the main source content is returned, else 0.
Diffuse Size / diffuseSize Float 2D 15, 15 Size of the background reflections.
Intensity / intensity Float 2 Controls the brightness of the reflections.
Use Luminance-Based Wrap / useLuminance Boolean On If disabled, the LightWrap is uniform instead of being affected by background luminance.
Enable Glow / enableGlow Boolean Off When enabled, the wrap is not masked by the foreground, creating a glow.
Foreground Blur Size / fgBlur Float 2D 1, 1 Blur applied to the foreground alpha matte; higher values leak more background.
Foreground Blur Border / fgBorderMode Choice Black Repeat
Black
Repeat RGB Black Alpha
Background Blur Size / bgBlur Float 2D 0, 0 Blur applied on the background before merging and diffuse blur.
Luma Tolerance / lumaTolerance Float 1 Luminance threshold; below this value pixels do not generate lightwrap.
Blend Mode / blendMode Choice Add

Add: Ac + Dc — adds source to destination.

Color Dodge: if Ac < 1 → min(1, Bc/(1 − Ac)); else 1.

Lighten: max(Ac, Bc).

Linear Dodge: min(Ac + Bc, 1).

Screen: Ac + Bc − Ac×Bc.

Hard-light: multiply/screen depending on Ac.

Hard Mix: vivid‑light threshold.

Linear Light: burn/dodge depending on Ac.

Overlay: multiply/screen depending on Bc.

Pin Light: removes mid‑tones.

Soft Light: multi‑branch soft‑light model.

Vivid Light: burn/dodge mix.

Difference: abs(A − B).

Divide: Ac / Bc (if valid).

Exclusion: Ac + Bc − 2AcBc.

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 ≤ Ba.

Disjoint Over: depends on Aa + Ba ≥ 1.

Geometric: 2AcBc/(Ac + Bc).

Grain Extract: Bc − Ac + 0.5.

Grain Merge: Bc + Ac − 0.5.

Hypot: sqrt(Ac² + Bc²).

Reflect: Aa²/(1−Ba).

Color Burn: 1 − min(1, (1−Bc)/Ac).

Darken: min(Ac, Bc).

Linear Burn: Bc + Ac − 1.

Multiply: Ac × Bc.

Multiply (Math): Ac × Bc (negatives preserved).

Background Source / colorMode Choice Previous Layer When set to Previous Layer, the spill comes from the prior layer; Custom Image uses a user‑selected image.
Previous Layer
Custom Image
Constant Color
Background Image / backgroundImage Image - The image used as background.
Constant Color / constantColor Color 1, 1, 1, 1 The constant color used when Color Mode is set to Constant Color.
Mask / mask Image -
Mix / mix_with_source Float 1 Dissolves between the original image (0) and the effect (1).
Color Correction / colorCorrection Category -
Master / master_group Category -
Saturation / master_saturation Color 1,1,1,1
Contrast / master_contrast Color 1,1,1,1
Gamma / master_gamma Color 1,1,1,1
Gain / master_gain Color 1,1,1,1
Offset / master_offset Color 0,0,0,0
Highlights / highlights_group Category -
Saturation / highlights_saturation Color 1,1,1,1
Contrast / highlights_contrast Color 1,1,1,1
Gamma / highlights_gamma Color 1,1,1,1
Gain / highlights_gain Color 1,1,1,1
Offset / highlights_offset Color 0,0,0,0
Midtones / mid_group Category -
Saturation / mid_saturation Color 1,1,1,1
Contrast / mid_contrast Color 1,1,1,1
Gamma / mid_gamma Color 1,1,1,1
Gain / mid_gain Color 1,1,1,1
Offset / mid_offset Color 0,0,0,0
Shadows / shadows_group Category -
Saturation / shadows_saturation Color 1,1,1,1
Contrast / shadows_contrast Color 1,1,1,1
Gamma / shadows_gamma Color 1,1,1,1
Gain / shadows_gain Color 1,1,1,1
Offset / shadows_offset Color 0,0,0,0