Light Wrap

Light Wrap operator properties for Script Engine. Bleeds colour and brightness from the background layer onto the foreground edges, recreating the natural way light wraps around a real subject. Useful as the final step after a chroma key to integrate a presenter into a virtual set, blend a gaming streamer's avatar with the scene behind them, soften hard composite edges, and make in-camera VFX shots look photographed rather than pasted. Apply after the keyer and after spill suppression for the most natural result.

Property	Type	Access	Description
`ShowAdvancedOptions`	`bool`	`get/set`	Reveals additional fine-tuning controls (edge softness, core penetration, luminance bias, saturation). Leave off for quick setup; turn on to refine the wrap on detailed shots.
`SelectLayerPropertyNote`	`PropertyNote`	`get/set`	Inline note shown above the background layer field; appears when no background layer has been selected.
`BackgroundSourceLayer`	`LayerRenderInfo`	`get/set`	The layer to sample for wrap colour. Pick the layer that sits behind the keyed subject in the final composite. Light Wrap will produce no effect until a valid background layer is selected here.
`BlurRadius`	`int`	`get/set`	Softness/spread of the wrap. [min=1, max=100, default=25]. Raise for diffuse, atmospheric wraps (good for blurry backgrounds); lower for crisp wraps that follow background detail closely.
`WrapWidth`	`int`	`get/set`	How far the wrap reaches inward from the foreground edges. [min=1, max=100, default=50]. Raise to push wrap further onto the subject for stronger integration; lower for a thin halo only at the very edge.
`Intensity`	`int`	`get/set`	Overall strength of the wrap effect. [min=0, max=200, default=100]. Raise for stronger, more visible wrap; lower for a subtle effect. Use 0 to disable without removing the operator.
`BlendMode`	`WrapBlendMode`	`get/set`	Blending mode used when combining the wrap with the foreground (Screen, Add, Lighten, Normal, Soft Light). Screen is the most natural choice; Add is brightest; Soft Light is the most subtle.
`EdgeSoftness`	`int`	`get/set`	Falloff curve at the wrap's edge. [min=10, max=200, default=100]. Raise for more gradual transitions; lower for crisper wrap edges.
`CorePenetration`	`int`	`get/set`	How far the wrap bleeds from edges into opaque areas of the foreground. [min=0, max=100, default=0]. Default 0 keeps wrap at the edges only; raise to spread wrap further into the subject for very strong integration.
`LuminanceBias`	`int`	`get/set`	Bias toward sampling brighter parts of the background. [min=0, max=100, default=50]. Higher values mimic real-world light, where bright areas of the scene are what actually wrap onto the subject.
`Saturation`	`int`	`get/set`	Colour intensity of the wrap. [min=0, max=200, default=100]. Lower for a more neutral wrap that only carries brightness; raise for a more colourful wrap that strongly tints the edges.
`OutputMode`	`WrapOutput`	`get/set`	What the operator outputs (Final, Foreground, Background, Blurred BG, Wrap Mask, Wrap Only). Switch to Wrap Only or Wrap Mask while tuning to inspect exactly where wrap is being applied.
`Minilog`	`FormattedMessage`	`get/set`	Status message showing the current background layer and key wrap settings.
`ResetAllCmd`	`Command`	`get/set`	Reset all settings to their defaults (blur 25, width 50, intensity 100, Screen blend, Final output).

Inherits from: AbstractOperator, AbstractAudioMetering.

See also: Light Wrap in Operators — user-facing introduction, screenshots, and section summaries.