Sapphire Plug-ins for AVX2: Layer

S_Layer

Layers the Foreground image over the Background using one of a variety of blending operations. The colors of each input can also be adjusted using the lights, darks, and saturation parameters.

In the Sapphire Composite category.


Inputs:

Foreground: The current track. The clip to use as foreground.

Background: Selectable. The clip to use as background. The output of the effect is composited over this clip.

Matte: Optional. Specifies the opacities of the Foreground clip. These values are scaled by the Fg Opacity parameter before being used.

Parameters:

Load Preset: Push-button .
Brings up the Preset Browser to browse all available presets for this effect.

Save Preset: Push-button .
Brings up the Preset Save dialog to save a preset for this effect.

Mode: Popup menu,  Default: Normal .
Determines which blending method is used to combine the foreground and background pixel colors.
Normal: a normal composite. This will just give the foreground as the result unless the Opacity is below 1.0 or an alpha channel is given.
Dissolve: randomly replaces background pixels with foreground. The opacity determines the probability, so the foreground is more likely to replace the background for higher values of Opacity.
Multiply: this can be used as an 'intersection' operation on matte images. White is the identity for Multiply, where one image contains white the other is not affected, so the result only contains white where both inputs are white.
Screen: this can be useful for combining the bright areas of two clips. It can also be used as a 'union' operation on matte images. Black is the identity for Screen, where one image contains black the other is not affected, so the result is white where either of the input images is white.
Overlay: combines foreground and background using an overlay function.
Soft Light: darkens or lightens the background depending on the foreground.
Hard Light: similar to overlay but with foreground and background swapped.
Color Dodge: brightens the background depending on the foreground.
Color Burn: darkens the background depending on the foreground.
Darken: the minimum of foreground and background. This can also be used as an 'intersection' operation with slightly different results than Multiply.
Lighten: the maximum of foreground and background. This can also be used as a 'union' operation with slightly different results than Screen.
Add: adds the foreground to the background.
Subtract: subtracts the foreground from the background.
Difference: similar to Subtract but the absolute value of the result is used, which tends to give more resulting colors in bounds. This can be used to select the regions of two matte images where one or the other is white, but not both.
Exclusion: similar to Difference but with smoother results.
Hue: combines the hue of the foreground with the saturation and luminance of the background.
Saturation: combines the saturation of the foreground with the hue and luminance of the background.
Chroma: combines the hue and saturation of the foreground with the luminance of the background.
Luminance: combines the luminance of the foreground with the hue and saturation of the background.
Linear Dodge: adds foreground and background and clamps the result at white.
Linear Burn: adds foreground and background but offsets to make the result darker. Similar to multiply in that combining with white gives no change and combining with black gives black.
Linear Light: performs a linear burn or linear dodge depending on if the foreground is more or less than 50 percent gray.
Vivid Light: performs a color burn or color dodge depending on if the foreground is more or less than 50 percent gray.
Pin Light: performs a lighten or darken depending on if the foreground is more or less than 50 percent gray.

Mocha: Default: 0, Range: 0 or greater.
Brings up the Mocha window for tracking footage and generating masks.

Blur Mocha: Default: 0, Range: 0 or greater.
Blurs the Mocha Mask by this amount before using. This can be used to soften the edges or quantization artifacts of the mask, and smooth out the time displacements.

Mocha Opacity: Default: 1, Range: 0 to 1.
Controls the strength of the Mocha mask. Lower values reduce the intensity of the effect.

Invert Mocha: Check-box,  Default: off.
If enabled, the black and white of the Mocha Mask are inverted before applying the effect.

Resize Mocha: Default: 1, Range: 0 to 2.
Scales the Mocha Mask. 1.0 is the original size.

Resize Rel X: Default: 1, Range: 0 to 2.
The relative horizontal size of the Mocha Mask.

Resize Rel Y: Default: 1, Range: 0 to 2.
The relative vertical size of the Mocha Mask.

Shift Mocha: X & Y,   Default: [0 0], Range: any.
Offsets the position of the Mocha Mask.

Bypass Mocha: Check-box,  Default: off.
Ignore the Mocha Mask and apply the effect to the entire source clip.

Show Mocha Only: Check-box,  Default: off.
Bypass the effect and show the Mocha Mask itself.

Combine Masks: Popup menu,  Default: Union .
Determines how to combine the Mocha Mask and Input Mask when both are supplied to the effect.
Union: Uses the area covered by both masks together.
Intersect: Uses the area that overlaps between the two masks.
Mocha Only: Ignore the Input Mask and only use the Mocha Mask.

Fg Opacity: Default: 1, Range: 0 to 1.
Scales the opacity of the effect. When this is decreased the result approaches the background. At zero, the result will equal the background.

Fg Lights: Default: 1, Range: 0 or greater.
Scales the Foreground before performing the effect.

Fg Darks: Default: 0, Range: any.
Offsets the darker regions of the Foreground before performing the effect. This can be negative to increase contrast.

Fg Saturation: Default: 1, Range: any.
Scales the color saturation of the Foreground before performing the effect. 0.0 makes it monochromatic, 1.0 has no effect.

Fg Hue Shift: Default: 0, Range: -1 to 1.
Shifts the hue of the colors in the Front clip, in revolutions from red to green to blue to red.

Fg Blur: Default: 0, Range: 0 or greater.
Amount to blur the foreground.

Bg Lights: Default: 1, Range: any.
Scales the Background before performing the effect.

Bg Darks: Default: 0, Range: any.
Offsets the darker regions of the Background before performing the effect. This can be negative to increase contrast.

Bg Saturation: Default: 1, Range: any.
Scales the color saturation of the Background before performing the effect. 0.0 makes it monochromatic, 1.0 has no effect.

Bg Hue Shift: Default: 0, Range: -1 to 1.
Shifts the hue of the colors in the Back clip, in revolutions from red to green to blue to red.

Bg Blur: Default: 0, Range: 0 or greater.
Amount to blur the background.

Result Lights: Default: 1, Range: 0 or greater.
Scales the result after performing the effect.

Result Darks: Default: 0, Range: any.
Offsets the darker regions of the result after performing the effect. This can be negative to increase contrast.

Result Saturation: Default: 1, Range: any.
Scales the color saturation of the result after performing the effect. 0.0 makes it monochromatic, 1.0 has no effect.

Result Hue Shift: Default: 0, Range: -1 to 1.
Shifts the hue of the colors in the result, in revolutions from red to green to blue to red.

Blur Subpixel: Check-box,  Default: on.
Enables blurring by subpixel amounts. Use this for smoother animation of the Blur Front and Blur Back parameters.

Swap Inputs: Check-box,  Default: off.
If enabled, effectively swaps the Background and Foreground inputs, and can be helpful for non-commutative operations like subtract. Note that this also causes parameters labeled 'Front' to affect the 'Back' input instead, and vice versa.

Comp Premult: Check-box,  Default: on.
Enable this for a better composite if the Foreground pixel values have been pre-multiplied by the original Matte pixel values. This will give an 'additive' composite when in Normal mode.

Matte Use: Popup menu,  Default: Alpha .
Determines how the Matte input channels are used to make a monochrome matte.
Luma: the luminance of the RGB channels is used.
Alpha: only the Alpha channel is used, or if there is no valid Alpha channel the Red channel is used.
All Opaque: an alpha of 1.0 is used as if the Matte were fully opaque.

Invert Alpha: Check-box,  Default: off.
If enabled, the black and white of the foreground alpha channel are inverted before use.
See general info for: Apply To Title/Key , Crop/Transform , Resolution , Clamp Output To Legal , Bypass Effect , and Reset .


See Also:

MathOps
Sapphire Plug-ins Introduction

List all effects with pictures

List all effects by name

List all effects with a brief summary

General User Info
What's New In This Version
Compatibility Notes
Loading a Plug-in
Color Management with OpenColorIO
Loading and Saving Presets
Designing Lens Flares and Glares
Using the Sapphire Effect Builder
Using Mocha in Sapphire
Resetting Parameters to Defaults
Online Documentation
About GPU Acceleration
About Motion Blur
About Matte Inputs
About Alpha Processing
About Angle Parameters
About Pixel Aspect Ratios
Customizing Plug-ins
Known Problems
3rd Party Licenses

Glow Effects
Glow
GlowAura
GlowDarks
GlowDist
GlowEdges
GlowNoise
GlowOrthicon
GlowRainbow
GlowRings
UltraGlow
ZGlow
Light Beams
Rays
EdgeRays
Streaks

LensFlares
LensFlare
LensFlareAutoTrack
LightLeak
Glints & Glares
Glint
GlintRainbow
Glare

Other Lighting
BokehLights
DropShadow
Flashbulbs
Light3D
SpotLight

AutoPaint & HalfTone
AutoPaint
Sketch
Etching
Brush:Oil
Brush:Chalk
Crosshatch
Cartoon
CartoonPaint
Posterize
HalfTone
HalfToneColor
HalfToneRings

Kaleidoscopes
Kaleido:Triangles
Kaleido:Squares
Kaleido:Diamonds
Kaleido:Oct
KaleidoPolar
KaleidoRadial
FlysEyeCircles
FlysEyeHex
FlysEyeRect
TileScramble
Film Effects & Grain
FilmEffect
FilmDamage
Vignette
BleachBypass
Grain
GrainStatic
UltraGrain
Diffuse
VintageColor2Strip
VintageColor3Strip

Edge Effects
EdgeDetect
EdgeDetectDouble
EdgesInDirection
EdgeColorize

Embossing
Emboss
EmbossShiny
EmbossDistort
EmbossGlass
Other Stylize
BandPass
ColorFuse
DogVision
DigitalDamage
JpegDamage
TVDamage
Grunge
Mosaic
PixelSort
PseudoColor
PsykoBlobs
PsykoStripes
PrismLens
RomanTile
ScanLines
ScanLinesMono
Solarize
StripSlide
Zebrafy
ZebrafyColor
ZFogExponential
ZFogLinear

Adjust
ChannelSwitcher
ClampChroma
DuoTone
Gamma
Hotspots
HueSatBright
Invert
Monochrome
OCIOTransform
QuadTone
Threshold
Tint
TriTone
ShowBadColors

Composite
EdgeFlash
Layer
MathOps
MatteOps
MatteOpsComp
ZComp
Blur+Sharpen
Beauty
Blur
BlurChannels
BlurChroma
BlurDirectional
BlurMoCurves
BlurMotion
DefocusPrism
Convolve
ConvolveComp
Deband
EdgeBlur
EdgeAwareBlur
FreeLens
GrainRemove
Median
RackDefocus
RackDfComp
Sharpen
SoftFocus
ZConvolve
ZDefocus
ZBlur

Distort Effects
Distort
DistortBlur
DistortChroma
DistortRGB
Warps & Shake
InfiniteZoom
ParallaxStrips
WarpBubble
WarpBubble2
WarpChroma
WarpCornerPin
WarpDrops
WarpFishEye
WarpMagnify
WarpPerspective
WarpPolar
WarpPuddle
WarpPuff
WarpRepeat
WarpTransform
WarpVortex
WarpWaves
WarpWaves2
Shake
StretchFrameEdges

Lightning Zaps
UltraZap
Zap
ZapTo
ZapFrom

Gradients, Grid & Shape
Gradient
GradientMulti
GradientRadial
Grid
Shape

Procedural Textures
Caustics
Sparkles
SparklesColor
TextureCells
TextureChromaSpiral
TextureFlux
TextureFolded
TextureLoops
TextureMicro
TextureMoire
TextureNeurons
TextureNoiseEmboss
TextureNoisePaint
TexturePlasma
TextureSpots
TextureTiles
TextureWeave

Fractal Clouds
Clouds
CloudsColorSmooth
CloudsMultColor
CloudsPerspective
CloudsPsyko
CloudsVortex
Other Render
Aurora
LaserBeam
Luna
MuzzleFlash
NightSky
Time Effects
CutToDissolve
Feedback
FeedbackBubble
FeedbackDistort
FieldRemove
FreezeFrame
GetFrame
JitterFrames
MotionDetect
NearestColor
RandomEdits
RepairFrames
Retime
ReverseClip
ReverseEdits
TimeAverage
TimeDisplace
TimeSlice
TimeWarpRGB
Trails
TrailsDiffuse

Flicker Tools
Flicker
FlickerMatch
FlickerMatchColor
FlickerMatchMatte
FlickerMchMatteColor
FlickerRemove
FlickerRemoveColor
FlickerRemoveMatte
FlickerRmMatteColor

Effect Builder
Effect
Transition
Dissolve Transitions
Dissolve
DissolveAutoPaint
DissolveBlur
DissolveBubble
DissolveDefocus
DissolveDiffuse
DissolveDigitalDamage
DissolveDistort
DissolveEdgeRays
DissolveFilm
DissolveFlashbulbs
DissolveGlare
DissolveGlint
DissolveGlintRainbow
DissolveGlow
DissolveLensFlare
DissolveLuma
DissolvePixelSort
DissolvePuddle
DissolveRays
DissolveShake
DissolveSpeckle
DissolveStatic
DissolveTiles
DissolveUltraGlow
DissolveVortex
DissolveWaves
DissolveZap

Wipe Transitions
WipeBlobs
WipeBubble
WipeCells
WipeChecker
WipeCircle
WipeClock
WipeClouds
WipeDiffuse
WipeDots
WipeDoubleWedge
WipeFlux
WipeFourWedges
WipeLine
WipePixelate
WipeRectangle
WipeRings
WipeStar
WipeStripes
WipeTiles
WipeWedge
WipePlasma
WipePointalize
WipeWeave
WipeMoire
SwishPan
Swish3D

Other Transitions
CardFlip
FilmRoll
FlutterCut
HyperPull
HyperPush
ParallaxStripsTransition
StripSlideTransition
SwishPan
Swish3D
TVChannelChange WhipLash