Sapphire Plug-ins for Open Fx: ZDefocus

S_ZDefocus

Defocuses areas of the source clip by different amounts using depth values from a ZBuffer input. Separates the input into a number of depth layers and applies different amounts of defocus depending on each layer's depth. To use this effect, first set ZBuffer:Black Is Near or White Is Near according to your Z buffer, then adjust the Focus Depth and Depth Of Field parameters to get the look you want. To help set the Focus Depth, you can use Show: In Focus Zone.

In the Sapphire Blur+Sharpen effects submenu.


Inputs:

Source: The clip to be processed.

ZBuffer: 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.

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.

Defocus Width: Default: 0.35, Range: 0 or greater.
Scales the overall defocus width. This parameter can be adjusted using the Defocus Width Widget.

Rel Height: Default: 1, Range: 0.01 or greater.
The relative height of the iris shape. If it is not 1, circles become ellipses, etc.

Zbuffer 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: Shows the final result of the effect.
In Focus Zone: Highlights the in-focus areas of the clip to make it easier to select the focal point and depth.
Shape: Show the iris shape instead of the defocused image.

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.

Shape: Popup menu,  Default: Circle .
Determines the shape of the simulated camera iris.
Circle: round.
3 sides: triangle.
4 sides: square.
5 sides: pentagon.
6 sides: hexagon.
7 sides: etc.

Roundness: Default: 0, 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, 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.

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.

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

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.

Highlight Threshold: Default: 0.9, Range: 0 to 1.
The minimum luma value for highlights. Pixels brighter than this will be brightened according to the Boost Highlights parameter.

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.

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.

Width Rel Near: Default: 1, Range: 0 or greater.
Scales the defocus width for parts of the image that are nearer than the focal plane.

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

Fog Near: Default: 0, Range: 0 to 1.
The amount of fog to add to nearby (close) objects.

Fog Far: Default: 0, Range: 0 to 1.
The amount of fog to add to far away objects.

Fog Color: Default rgb: [0.5 0.5 0.5].
The fog color should normally match the sky or background color of the source clip. Use gray for mist, brown for smog, blue for underwater, etc.

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.

Zbuffer 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.

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.

Show Defocus Width: Check-box, Default: on.
Turns on or off the screen user interface for adjusting the Defocus Width parameter.


See Also:

RackDefocus
ZBlur
ZGlow
ZConvolve
ZFogLinear
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