An effect which lets you replace a given luminance range in the source image with another image or solid color.

Effect Parameters

Presets
Presets contain a snapshot of the plug-in parameters. The Presets control lets you choose among one of the presets built into the plug-in, save current parameter values to a preset file, or load an existing preset file from disk.
A preset file saved to disk via the "Save As" button can be loaded from another instance of the same plug-in by clicking the "Open" button. Presets generated in one host can also be loaded from the same plug-in when used in a different host.

Source Value, Aperture and Softness
The effect is applied to a given range of pixels, based on their luminance value. Luminance values range from 0 (black) to 1 (white). The "Source Value", "Source Aperture" and "Source Softness" parameters give you precise controls to define this range:




The "Source Luminance" parameter specifies the center of the range of pixels. For example, a value of 0.5 means that the effect is applied to pixels that are 50% bright.

The "Source Aperture" parameter controls the width of this range. For example, a value of 0.5 with aperture of 0.2 means that all pixels between 40% and 60% brightness will be used as the source for the effect. An aperture value of 1.0 means that the effect is applied to the entire image.

It may be desirable to have a smooth transition between the pixels that are within the range and those that fall outside it. The "Source Softness" parameter defines the width of this smooth border. By adding soft borders to the range (one at the start, one at the end) you eliminate the sharp transition. A softness of 1.0 means that the range is smoothed over the entire image.



Replacement Source
Controls whether the the luminance range is replaced by some other media, or by a solid color. When "Media" is selected, the image well parameter may be used to supply clips or static images to the effect.

Replacement Media
The media used to replace the given luminance range when the "Replacement Source" parameter is set to "Media".

Replacement Method
When the current replacement source is "Media", this parameter lets you control whether the replacement image is tiled or stretched over the frame.

Replacement Color and Opacity
When the current replacement source is "Color", these parameters control the color and opacity used to replace the given luminance range.

Color Space
This parameter allows you to choose a working color space for the effect. When the “Linear” option is selected, the plug-in will convert all color values to a non-gamma-corrected format. When the “Uncorrected” option is selected, the color values supplied by the host will be used directly, without conversion. It may help to choose “Uncorrected” when dealing with smooth gradients or vector-art backgrounds, or if you have already applied gamma correction to your source media in a previous step of your workflow.