Sapphire Plug-ins for AVX2: ZConvolve

S_ZConvolve

Convolves areas of the source clip using a kernel which is made larger or smaller using depth values from a ZBuffer input. Separates the input into a number of layers and applies different sized convolution blurs depending on the distance from the focal depth, and depth of field. This is similar to ZDefocus but with an iris shape (or Kernel) that comes from a clip.

In the Sapphire Blur+Sharpen category.


Inputs:

Source: The current track. The clip to be processed.

Z Buffer: Selectable. The input clip containing depth values for each Source pixel. These values should be in the range of black to white, and it is best if not anti-aliased. Normally black corresponds to the farthest objects and white to the nearest, though this can be adjusted using Z Buffer parameter.

Kernel: Selectable. The filter kernel or shape for the convolution. This should normally be all black around the edges (outside the specified Kernel Crop region), with a non-black central part. A larger shape normally produces blurrier results. Only the part of the kernel within the two Kernel Crop params is considered; the part outside that boundary is ignored.

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

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.

Focal Depth: Default: 0, Range: any.
The depth of the focus plane; 0 is near and 1 is far. Areas with this Z value will be in focus. Objects near this depth may be in focus depending on the Depth of Field parameter. You can use Show: In Focus Zone to show the Focal Depth when adjusting. If the effect of this parameter seems backwards, you can invert the depth values using the Z Buffer parameter.

Depth Of Field: Default: 0.1, Range: 0 to 1.
Specifies how wide a range of depths near the Focal Depth will be in focus. If the Focal Depth is 0.5 and Depth of Field is 0.2, all objects with Z values from 0.4 to 0.6 will be in focus. Set to zero to have only objects exactly at the Focal Depth in focus. You can use Show: In Focus Zone to show this when adjusting.

Size: Default: 1, Range: 0 or greater.
The maximum amount to resize the kernel larger or smaller. 1.0 is the original size. This parameter can be adjusted using the Size Widget.

Size Rel X: Default: 1, Range: 0 or greater.
Increase to make the kernel fatter or wider without changing its height. Decrease to shrink it horizontally, making it thinner.

Size Rel Y: Default: 1, Range: 0 or greater.
Increase to make the kernel taller without changing its wieght. Decrease to shrink it vertically, making it flatter.

Size Rel Near: Default: 1, Range: 0 or greater.
Scales the kernel size for parts of the image that are nearer than the focal plane.

Size Rel Far: Default: 1, Range: 0 or greater.
Scales the kernel size for parts of the image that are farther away than the focal plane.

Layers: Integer,  Default: 5, Range: 2 to 50.
The number of depth layers to separate the source into. More layers require more processing but give smoother results in Z. More layers are sometimes needed to avoid visible seams between the layers.

Layer Mode: Popup menu,  Default: Interp .
Determines how the differently blurred layers are combined.
Comp: the closer layers are composited over the farther layers. This method often gives better results if you have objects at different depths overlapping each other with discontinuous values in your depth image. However, this option can be slower, and sometimes artifacts between layers are visible.
Interp: the layers are interpolated using depth image values. This method gives smoother transitions between layers, and is usually better if there are no sharp changes in your depth image.

Z Buffer Type: Popup menu,  Default: White is Near .
How to interpret the values in the Z buffer.
Black is Near: Black pixels in the Z buffer indicate that the object at that point is near (close to you), and white means far away.
White is Near: White pixels in the Z buffer indicate that the object at that point is near (close to you), and black means far away.

Show: Popup menu,  Default: Result .
Selects the type of output.
Result: Show the final output.
Kernel: Show the convolve kernel over the final output. Use this to adjust the kernel cropping and threshold parameters.
In Focus Zone: Show the in-focus zone highlighted over the original image. Use this to adjust the focal depth and depth of field.

Z Buffer Use: Popup menu,  Default: Luma .
Determines how the ZBuffer input channels make a monochrome z image.
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.

Use Gamma: Default: 1, Range: 0.1 or greater.
Values above 1 cause highlights in the source clip to keep their brightness after the convolution filter is applied.

Brightness: Default: 1, Range: 0 or greater.
Scales the brightness of the result.

Threshold: Default: 0, Range: 0 or greater.
Any source value below this will be treated as black. When combining the convolved result with the original, you can increase this value to only convolve bright areas of the source. Typically when using this parameter, you will also set Combine to Screen or Add to get a glare-like effect.

Threshold Add Color: Default rgb: [0 0 0].
This can be used to raise the threshold on a specific color and thereby reduce the convolved result generated on areas of the source clip containing that color.

Mix With Source: Default: 0, Range: 0 to 1.
Interpolates between the convolved result (0) and the original source (1). 0.1 can give a nice misty effect since it mixes only a little of the source in.

Combine: Popup menu,  Default: Convolve Only .
Determines how the convolved image is combined with the original source.
Convolve Only: Only show the convolved image. Use this option for a blur or defocus-like effect
Screen: Screen the convolved image with the original source. Use this option for a glow or glare-like effect.
Add: Add the convolved image to the original source.
Difference: Show the difference between the convolved image and the source.

Edge Mode: X & Y,  Popup menu,  Default: [ Black Black ].
Determines the behavior when accessing areas outside the source image.
Black: Areas outside the source image are treated as black, which can produce dark areas 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.

Kernel Details Parameters:

Kernel Crop1: X & Y,  Default: screen lower left.
The upper left corner of the kernel area. Parts of the kernel image outside the rectangle defined by Kernel Crop1 and Kernel Crop2 are assumed to be black. Making this area smaller to avoid processing the kernel's black edges can speed up the convolution somewhat. It may be helpful to turn on Show Kernel while adjusting this parameter. Note that if Autocenter is off, the center point is always included in the kernel no matter what this param is set to.

Kernel Crop2: X & Y,  Default: screen lower left.
The lower right corner of the kernel area.

Kernel Center: X & Y,  Default: screen center.
The center point of the kernel; if you think of convolution as repeated stamping of the kernel at each point of the source, the center is where the stamp aligns with the source pixels it's stamped over. If you move the center to the right in the kernel, the whole result image will move to the left, and similarly up and down. This parameter is ignored if AutoCenter is on. It may be helpful to turn on Show Kernel while adjusting this parameter. Note that if Autocenter is off, the center point is always included in the kernel no matter what this param is set to.

Kernel Threshold: Default: 0.001, Range: 0 or greater.
Any kernel value below this will be treated as black. It's important for the edges of the kernel image to be completely black, or the result will have a grayish cast to it. If your kernel image may have a little noise in the black areas, turn up threshold a little to remove that background noise.

Clamp Below Threshold: Check-box,  Default: on.
When turned on, values below the threshold are clamped to zero. This usually gives the best result. For certain special cases with partially-negative kernels, turning this off gives you additional flexibility in designing your kernel.

Autocenter: Check-box,  Default: on.
Automatically finds the center of the kernel image. Turning this on makes the effect ignore the Kernel Center parameter.

Autoscale Mode: Popup menu,  Default: Max Channel .
In convolution, either a larger or brighter kernel will make the result image brighter. The kernel must be auto-scaled or normalized so the result is, on average, as bright as the input. The autoscaling can be done in several ways, each of which is best in certain circumstances. With a monochrome kernel or with Color Kernel turned off, Max Channel, Luma, and Indep Channels all give the same result.
Max Channel: Autoscales the kernel by summing the elements of each channel, and using whichever is brightest as the overall kernel scale factor. This normalizes a dim kernel to full brightness, and generally preserves the color of the kernel, but allows brightness variations in the dimmer channels to show in the result.
Luma: Autoscales the kernel by summing the luminances of each kernel pixel. This method preserves changes in the kernel's hue, but normalizes the luma, so a brighter or darker kernel will have no effect. Use the Scale parameter to adjust the result brightness.
Indep Channels: Independently normalizes each color channel of the kernel. A colored kernel will give a white/gray result with this method. Use this method if your kernel channels are independent of each other (i.e. different things going on in each of R, G, and B) but you want normalized results in each channel.
Count Nonzero: Count how many kernel pixels are nonzero (brighter than black), but otherwise ignore how bright they are. This method is best if you want variations in kernel hue and luma to show up in the result. But blurring the kernel will give a dimmer result, since there will be more nonzero pixels.
Kernel Size: Ignore the pixel values entirely; only use the size of the kernel rectangle to auto-scale. Use this if you want all kernel variations to show up in the result, but don't use it if you intend to animate Kernel Crop1 and Crop2, as that would affect the result's brightness.

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.
See general info for: Apply To Title/Key , Crop/Transform , Resolution , Clamp Output To Legal , Bypass Effect , and Reset .


See Also:

ZDefocus
ZBlur
ZGlow
ZFogLinear
Convolve
RackDefocus
Glare
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