Sapphire Plug-ins for Open Fx: ZapTo

S_ZapTo

Generates a forked lightning bolt from a given point to the edges of objects in the ToObject input clip, and renders it over a background input. Use the Show:Edges option to view the target edges while adjusting the Threshold and Blur To Obj parameters.

In the Sapphire Render effects submenu.


Inputs:

Background: The clip to use as background. If none is selected the main input (the current layer) is also used for the background.

ToObject: Optional. The edges of objects in this clip are extracted, and the lightning connects to points along these edges facing towards the starting point.

Mask: Optional. If provided, this input is used to control which edges are used to attract the lightning. Edges found in black areas will not be used. Edges found in white areas will be used as normal. Edges found in grey areas will be scaled down.

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.

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.

Surface Points: Integer,  Default: 10, Range: 1 to 500.
The number of points along the edges to connect the lightning to. These surface points are divided up amongst the shapes in the ToObject input. If the number of requested surface points is equal to the number of separate shapes in the ToObject input, one lightning fork will connect to each.

Bolts: Integer,  Default: 1, Range: 1 to 200.
The number of independent forked lightning bolts to draw, each connecting the Start position with the edge points.

Start: X & Y,   Default: [0 0], Range: any.
The starting position of the lightning.

Max Dist: Default: 2, Range: 0 to 5.6.
The maximum distance of surface points from the Start position. Edges outside this distance are ignored.

Threshold: Default: 0.5, Range: 0 or greater.
The value used to determine the edge locations. Objects darker than this value are ignored. On smooth objects, larger threshold values move the edges inwards to make smaller shapes, and smaller values move the edges outwards. You can use the Show Edges option to view the edge image directly while adjusting this parameter.

Blur ToObj: Default: 0.0224, Range: 0 or greater.
Blurs the ToObject input clip before finding the edges. This can help remove noise, and reduce the number of separate shapes. You can use the Show Edges option to view the edge image directly while adjusting this parameter.

ToObj Use: Popup menu,  Default: Luma .
Determines which channel of the ToObject input channels are used.
Luma: the luminance of the RGB channels is used.
Alpha: only the Alpha channel is used.

Show: Popup menu,  Default: Result .
Selects what the effect will output.
Result: shows the normal lightning result over the background.
Edges: shows the target edge image. This can be useful to view while adjusting the Threshold and Blur To Obj parameters.

Bolt Width: Default: 0.07, Range: 0 or greater.
The width of the lightning bolts.

Vary Width: Default: 0, Range: 0 to 1.
The amount of random variation in the width of the bolts along their lengths.

End Pointiness: Default: 0.25, Range: 0 to 1.
Determines how pointed the end of the bolts are. If 0, the entire bolt will have equal width. If 1, the bolts will thin out along their entire length for a pointed end. If it is .5, the bolts will start thinning out half way between the start and end points.

Wiggle Start: Default: 0, Range: 0 or greater.
By default the bolts automatically wiggle over time. This parameter provides a starting offset for these bolt perturbations.

Wiggle Speed: Default: 1, Range: 0 or greater.
The speed at which the bolts are perturbed automatically over time. To animate changes in speed, set this to zero and animate the Wiggle Start parameter instead.

Jitter Frames: Integer,  Default: 0, Range: 0 or greater.
If this is 0, the same random lightning will be used for every frame processed. If it is 1, different random lightning is used for each frame. If it is 2, new random lightning is used for every other frame, and so on.

Rand Seed: Default: 0.123, Range: 0 or greater.
Used to initialize the random number generator. The actual seed value is not significant, but different seeds give different random lightning bolts, and the same value should give a repeatable result.

Wrinkle Amp: Default: 1, Range: 0 or greater.
Scales the amount of wrinkles in the bolts. Decrease for straighter smoother bolts or increase for more kinky bolts.

Branchiness: Default: 1, Range: 0 to 20.
Scales the number of additional bolts that branch from the main bolt. Set this to 0 for basic bolts with no extra branches.

Branch Angle: Default: 65, Range: 0 to 180.
The maximum angle of the random branches relative to the bolt they are branching off of. If this is 0 the branches will be more lined up with the main bolt. With larger values the branches will be more perpendicular to the main bolt.

Branch Length: Default: 0.5, Range: 0 to 3.
The scaled length of the branches relative to the distance between the Start and End points.

Glow Parameters:

Glow Bright: Default: 2, Range: 0 or greater.
Scales the brightness of the glow applied to the lightning.

Glow Color: Default rgb: [0.5 0.5 1].
The color of the glow applied to the lightning.

Glow Width: Default: 0.224, Range: 0 or greater.
The width of the glow applied to the lightning.

Glow Width Red: Default: 0.5, Range: 0 or greater.
The relative red width of the glow.

Glow Width Grn: Default: 1, Range: 0 or greater.
The relative green width of the glow.

Glow Width Blue: Default: 1.5, Range: 0 or greater.
The relative blue width of the glow.

Affect Alpha: Default: 0, Range: 0 or greater.
If this value is positive the output Alpha channel will include some opacity from the lightning and its glow. The maximum of the red, green, and blue brightness is scaled by this value and combined with the background Alpha at each pixel.

Other Parameters:

Zap Bright: Default: 1, Range: 0 or greater.
Scales the brightness of the lightning bolts.

Zap Color: Default rgb: [1 1 1].
The color of the lightning. If you want to keep the lightning bolt itself bright white, you can still affect the perceived color by adjusting the Glow Color instead.

Start Offset: Default: 0, Range: 0 to 1.
The offset from the start point to begin drawing the bolts. This can be useful for animating a lightning strike.

Length: Default: 1, Range: 0 to 1.
The length of the bolts, beginning at Start Offset. If less than 1, the bolts will not be drawn all the way from start to end. This can be useful for animating a lightning strike.

Bg Brightness: Default: 1, Range: 0 or greater.
Scales the brightness of the background before combining with the lightning. If 0, the result will contain only the lightning image over black.

Combine: Popup menu,  Default: Screen .
Determines how the lightning and glow are combined with the Background.
Screen: performs a blend function which can help prevent overly bright results.
Add: causes the lightning to be added to the background. This gives brighter glows over light backgrounds.
Zap Only: displays the lightning over black, ignoring the source image.

Atmosphere Amp: Default: 0, Range: 0 or greater.
Atmosphere gives the effect of the zap shining through a dusty atmosphere and picking up light or getting shadowed. This parameter adjusts the amount, or amplitude, of the atmospheric effect. Zero gives a smooth zap, higher values give more dusty look.

Atmosphere Freq: Default: 2, Range: 0.1 to 20.
Controls the spatial frequency of the atmospheric noise. Turn this up higher to get finer details, turn down for broader overall variation.

Atmosphere Detail: Default: 0.7, Range: 0 to 1.
Controls the amount of fine detail in the atmosphere simulation. Decrease to get smoother atmosphere, increase for a more crunchy or grainy look.

Atmosphere Seed: Default: 0.123, Range: 0 or greater.
Used to initialize the random number generator for the atmospheric noise. The actual seed value is not significant, but different seeds give different results and the same value should give a repeatable result.

Atmosphere Speed: Default: 1, Range: any.
The cloudy noise in the atmosphere evolves over time like real dust clouds; this parameter controls how fast the cloud pattern changes over time. Set to zero for a static pattern.

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.

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 Start: Check-box, Default: on.
Turns on or off the screen user interface for adjusting the Start parameter.
See general info for Motion Blur


See Also:

Zap
ZapFrom
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