S_AdvancedDefocusGenerates a defocused version of the source clip using a 'circle of confusion' convolution. This effect is often preferable to a gaussian blur for simulating a real defocused camera lens, because bright spots can be defocused into clean shapes instead of being smoothed away. The iris shape can be controlled using Points, Pointiness and Rotate, and the Use Gamma and Boost Highlights parameters can adjust the relative brightness of the blurred highlights. Use the params in the Lens Vignette group to simulate optical vignetting and matte box artifacts.In the Sapphire Blur+Sharpen effects submenu. Inputs:
|
|
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.
- Mocha Project:
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.
- Dilate Mocha:
Default:
0,
Range:
-100 to 100.
Dilates or erodes the Mocha Mask by this pixel amount before using.
- Dilation Quality:
Popup menu, Default: Fast
.
Selects whether Dilate Mocha adusts quickly in default Fast mode or looks better in High quality mode.- Fast:
Dilate Mocha in Fast mode for quick adjustments.
- High: Dilate Mocha in High quality mode for a better looking mask shape.
- High: Dilate Mocha in High quality mode for a better looking mask shape.
- Fast:
Dilate Mocha in Fast mode for quick adjustments.
- 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.
- Intersect: Uses the area that overlaps between the two masks.
- Union:
Uses the area covered by both masks together.
- Defocus Width:
Default:
0.088,
Range:
0 or greater.
The width of the defocus. This parameter can be adjusted using the Defocus Width Widget.
- Defocus Rel:
X & Y, Default:
[1 1],
Range:
0.01 or greater.
The relative width and height of the iris shape. If it is not 1, circles become ellipses, etc. This parameter can be adjusted using the Defocus Width Widget.
- Shape:
Popup menu, Default: Polygon
.
Determines the shape of the simulated camera iris.- Circle:
round.
- Polygon: polygon controlled by the Points parameter.
- Custom: custom image, select with the Custom Lens parameter.
- Polygon: polygon controlled by the Points parameter.
- Circle:
round.
- Points:
Integer, Default:
5,
Range:
3 or greater.
The number of points in the shape of the simulated camera iris.
- Custom Lens:
Popup menu, Default: 01 - Cascading Blade
.
Selects from a list of images for the lens shape.
- Show:
Popup menu, Default: Result
.
Selects the type of output.- Result:
shows the defocused image.
- Shape (Actual Size): Show the iris shape instead of the defocused image.
- Shape (Zoomed In): Show the iris shape, zoomed in to fill the frame.
- Shape (Actual Size): Show the iris shape instead of the defocused image.
- Result:
shows the defocused image.
- Roundness:
Default:
0.3,
Range:
any.
Modifies the shape of the simulated camera iris. A value of 1 produces a circle; 0 gives a flat-sided polygon with a number of sides given by the Shape parameter. Less than 0 causes the sides to squeeze inward giving a star shape, while a value greater than 1 causes the corners to squeeze inward, giving a flowery shape. Has no effect if the Shape is set to Circle.
- Rotate:
Default:
0,
Range:
any.
Rotates the iris shape.
- Bokeh:
Default:
-0.3,
Range:
any.
Softens the outer edge of the iris shape, which gives a softer look to the defocused highlights. A negative value darkens the center of the iris shape, producing a ring-like defocus shape.
- Bokeh Softness:
Default:
1,
Range:
0 to 1.
Controls the softness of the bokeh effect.
- Bokeh Center:
Default:
0.5,
Range:
0 to 1.
Adjusts the center between the inner and outer parts of the bokeh effect.
- Notch Depth:
Default:
0,
Range:
0 to 1.
Controls the depth of lens notching in the iris shape. Only applies when Shape is set to Polygon.
- Notch Angle:
Default:
0.05,
Range:
0 to 1.
Controls the angle of lens notching in the iris shape.
- Color Fringing:
Default:
0,
Range:
any.
Produces rings of color around every object in the image by varying the focal distance for each color channel. It gives a different style of chromatic aberration from Chroma Distort because it's not just in the image corners.
- Color Fringing Style:
Popup menu, Default: Red/Blue
.
Selects the type of color fringing.- Red/Blue:
Creates a double fringe: orange and red for
negative Color Fringing or cyan and blue for positive Color Fringing.
- Green/Magenta: Creates a single fringe: green for negative Color Fringing or magenta for positive Color Fringing.
- Green/Magenta: Creates a single fringe: green for negative Color Fringing or magenta for positive Color Fringing.
- Red/Blue:
Creates a double fringe: orange and red for
negative Color Fringing or cyan and blue for positive Color Fringing.
- Lens Noise:
Default:
0,
Range:
0 or greater.
Increase to add noise to the iris shape, dirtying up the defocus a little. Can make the result more realistic. Turn up past 1 for a more stylistic result.
- Noise Freq:
Default:
40,
Range:
0.01 or greater.
The frequency of the added noise. Ignored if Lens Noise is zero.
- Noise Freq Rel X:
Default:
1,
Range:
0.01 or greater.
The relative horizontal frequency of the added iris noise. Increase to stretch it vertically or decrease to stretch it horizontally.
- Noise Seed:
Default:
0.123,
Range:
0 or greater.
The seed value for the added noise. To make the noise appear different on each frame, animate this to be different on each frame. The actual value doesn't matter; only that it's different.
- Optical Vignette:
Default:
0,
Range:
-1 to 1.
Simulates optical vignetting, which crops the defocused highlights into a pointed ellipse shape and darkens the output. The effect is stronger near the edges of the frame. Larger values increase the amount of cropping, and cause the effect to extend more toward the center of the frame. Positive values crop the inner edges of the highlights, and negative values crop the outside edges.
- Vignette Size:
Default:
1,
Range:
1 or greater.
Controls the relative size of the vignette crop circle. Larger values will reduce the intensity of the effect, as well as the curvature of the cropped edge.
- Matte Box Left:
Default:
0,
Range:
0 to 4.
Crops the inner edge of defocused highlights on the left side of the frame. Larger values increase the amount of cropping and extend it farther across the frame.
- Matte Box Right:
Default:
0,
Range:
0 to 4.
Crops the inner edge of defocused highlights on the right side of the frame. Larger values increase the amount of cropping and extend it farther across the frame.
- Matte Box Top:
Default:
0,
Range:
0 to 4.
Crops the inner edge of defocused highlights on the top of the frame. Larger values increase the amount of cropping and extend it farther across the frame.
- Matte Box Bottom:
Default:
0,
Range:
0 to 4.
Crops the inner edge of defocused highlights on the bottom of the frame. Larger values increase the amount of cropping and extend it farther across the frame.
- Texture:
Popup menu, Default: None
.
Selects an texture image to combine with the lens.- None:
No texture on the lens.
- 01 - Color Noise: noisy color pattern.
- 02 - Red Blue Gradient: vertical red to blue gradient.
- 03 - Blue Yellow Gradient: vertical blue to yellow gradient.
- 04 - Green Purple Gradient: vertical green to purple gradient.
- 05 - Random Dirt 01: lens dirt (1).
- 06 - Random Dirt 02: lens dirt (2).
- 07 - Cluster: noise with larger dirts clustered in the center.
- 08 - Big Spot: lens dirt with a large centered spot.
- 09 - Rings And Waves: lens dirt with lots of rings.
- 10 - Scratchy: scratched lens.
- 11 - Small Specks: small dirt specks.
- 12 - Residue 01: residue on lens (1).
- 13 - Residue 02: residue on lens (2).
- 14 - Subtle Noise: faint small noise pattern.
- 15 - Lens Fungus: faint blobby noise pattern.
- 01 - Color Noise: noisy color pattern.
- None:
No texture on the lens.
- Texture Scale:
Default:
1,
Range:
0.1 or greater.
Scales the size of the texture.
- Texture Scale Rel Y:
Default:
1,
Range:
1 or greater.
Scales the relative height of the texture.
- Texture Shift:
X & Y, Default:
[0 0],
Range:
-5 to 5.
Moves the texture relative to the lens.
- Texture Rotate:
Default:
0,
Range:
any.
Rotates the texture.
- Texture Intensity:
Default:
1,
Range:
0 to 1.
Adjusts the intensity of the texture overlay. When set to 1, the lens is multiplied by the texture. Lower values mix in more of the original lens, with a value of 0 disabling the texture entirely.
- Grain Amp:
Default:
0,
Range:
0 or greater.
Scales the amplitude of the grain that is added to the result. Set this to 0 to disable all grain.
- Grain Amp Brights:
Default:
0,
Range:
0 or greater.
The relative amount of grain applied to the brightest regions of the image, per channel. Bright source intensity in the image is defined as white (1 1 1).
- Grain Amp Darks:
Default:
0.37,
Range:
0 or greater.
The relative amount of grain applied to the darkest regions of the image, per channel. Dark source intensity in the image is defined as black (0 0 0).
- Grain Amp Mids:
Default:
1,
Range:
0 or greater.
The relative amount of grain applied to the midtone regions of the image, per channel. Midtone source intensity in the image is defined by the Midtone Pos parameters.
- Grain Size:
Default:
1,
Range:
0.001 or greater.
Scales the size of the grain that is added to the result. Useful when changing resolution, set this scale factor to match the change in resolution.
- Grain Blur:
Default:
0.00567,
Range:
0 or greater.
The grain is smoothed by this amount. Increase for coarser grain.
- Grain Mono:
Check-box, Default:
off.
When enabled, the same grain pattern is used for the red, green, and blue channels. To make truly monochrome grain you should also set Grain Amp Red/Green/Blue equal to each other, make sure Midtone Pos Red/Green/Blue are equal, and if GrainBlur is positive also set Grain Blur Red/Green/Blue equal
- Grain Seed:
Default:
0.123,
Range:
0 or greater.
Initializes the random number generator for the grain generation. The actual seed value is not significant, but different seeds give different grain patterns and the same value should give a repeatable pattern.
- Boost Highlights:
Default:
0,
Range:
0 or greater.
The amount to increase the luma of the highlights in the source clip. Increase this parameter to blow out the highlights without affecting the darks or mid-tones.
- Hilight Threshold:
Default:
0.9,
Range:
0 or greater.
The minimum luma value for highlights. Pixels brighter than this will be brightened according to the Boost Highlights parameter.
- Chromatic Aberration:
Default:
0,
Range:
any.
Adds some chromatic aberration around the edges of the image; red and blue wavelengths of light refract differently in real lenses, producing fringes of color where the rays strike the lens at oblique angles.
- Use Gamma:
Default:
1.8,
Range:
0.1 or greater.
Values above 1 cause highlights in the source clip to keep their brightness after the defocus is applied.
- Brightness:
Default:
1,
Range:
0 or greater.
Scales the brightness of the result.
- Offset Darks:
Default:
0,
Range:
any.
Adds this gray value to the darker regions of the result. This can be negative to increase contrast.
- Gauss Blur:
Default:
0,
Range:
0 or greater.
If positive, a gaussian blur is also applied which smooths out the edges of the shapes. This might also darken the highlights because Gamma is not considered in the gaussian blur.
- Mix With Source:
Default:
0,
Range:
0 to 1.
Interpolates between the defocused result and the original source. Set this to 1 for the original source.
- Edge Mode:
Popup menu, Default: Reflect
.
Determines the behavior when accessing areas outside the source image.- Transparent:
Areas outside the source image are treated as transparent, which can produce
transparency around the edges of the image.
Select this for fastest rendering.
- Repeat: Repeats the last pixel outside the border of the image.
- Reflect: Reflects the image outside the border.
- Repeat: Repeats the last pixel outside the border of the image.
- Transparent:
Areas outside the source image are treated as transparent, which can produce
transparency around the edges of the image.
Select this for fastest rendering.
- Resolution:
Popup menu, Default: Full
.
Selects the resolution factor for the defocus. Higher resolutions give better quality, lower resolutions give faster processing.
- Affect Alpha:
Check-box, Default:
off.
If enabled, defocus the alpha channel as well as the color channels. Otherwise, only defocus the color channels, leaving alpha unchanged.
- Soft Borders:
Check-box, Default:
off.
If enabled, transparent borders are added to the input image before processing. This allows the result to include soft edges beyond the original image size. When off, the effect only occurs within the frame and the result will retain an edge at the borders.
- Mask Use:
Popup menu, Default: Luma
.
Determines how the Mask input channels are used to make a monochrome mask.- Luma:
the luminance of the RGB channels is used.
- Alpha: only the Alpha channel is used.
- Alpha: only the Alpha channel is used.
- Luma:
the luminance of the RGB channels is used.
- Blur Mask:
Default:
0.05,
Range:
0 or greater.
Blurs the Mask input by this amount before using. This can provide a smoother transition between the masked and unmasked areas. It has no effect unless the Mask input is provided.
- Invert Mask:
Check-box, Default:
off.
If on, inverts the mask input so the effect is applied to areas where the Mask is black instead of white. This has no effect unless the Mask input is provided.
- Show Defocus Width:
Check-box, Default:
on.
Turns on or off the screen user interface for adjusting the Defocus Width parameter.
See Also:
RackDefocus
DefocusPrismRackDfComp
Blur
BlurChannels
BlurChroma
ZDefocus
ConvolveSapphire Plug-ins Introduction
