Sapphire Plug-ins for Autodesk: BokehLightsMask

BokehLightsMask

Generates random, defocused lights that move around the screen. Similar to BokehLights, but a Mask input controls where the lights are visible.

Inputs:

Source: The clip to be processed.

Mask: The color of each light is scaled by the color of this clip at the center of the light. A black and white mask can be used to create lights that are obscured by foreground objects. A color mask will colorize the lights, which can give the appearance of the lights passing behind a partially-transparent object.

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.

Color: Default rgb: [1 1 0.3].
The overall color of the lights.

Brightness: Default: 0.5, Range: 0 or greater.
The overall brightness of the lights.

Vary Hue: Default: 0, Range: 0 to 1.
Randomly varies the hue of each light.

Vary Saturation: Default: 0, Range: 0 to 1.
Randomly varies the saturation of each light.

Vary Brightness: Default: 1, Range: 0 to 1.
Randomly varies the brightness of each light.

Seed: Default: 0.123, Range: 0 or greater.
Initializes the random number generator for light positioning, size, and color variation. The actual seed value is not significant, but different seeds give different results and the same value should give a repeatable result.

Combine: Popup menu,  Default: Screen .
Determines how the lights are combined with the Source clip.
Screen: performs a blend function which can help prevent overly bright results.
Add: the lights are added to the source.
Lights Only: gives only the lights with no background.

Size: Default: 0.3, Range: 0 or greater.
The overall size of the defocused lights. This parameter can be adjusted using the Size 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.

Vary Size: Default: 0.2, Range: 0 or greater.
Randomly varies the size of the lights, to simulate lights that are at different distances from the camera.

Softness: Default: 0.01, Range: 0.001 or greater.
The softness of the light sources. Increase this for blurrier lights.

Lights: Integer,  Default: 30, Range: 0 or greater.
The number of lights.

Shape: Popup menu,  Default: 7 sides .
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.

Drift Speed: Default: 0.2, Range: 0 or greater.
The speed at which lights move around the screen.

Drift Distance: Default: 0.5, Range: 0 or greater.
The maximum distance that each light will move.

Drift Size Speed: Default: 0.1, Range: 0 or greater.
The speed at which lights change their size.

Drift Size Distance: Default: 0.3, Range: 0 or greater.
The maximum amount by which each light's size will change.

Drift Smoothness: Default: 0.65, Range: 0 to 1.
Controls the amount of high frequency variation in each light's motion. Increase this for a gentle drifting motion. Decrease for a jerky shaking motion.

Use Source Color: Default: 0.25, Range: 0 to 1.
Scales the lights by a smoothed version of the Source clip. Increase this to help the lights blend with the background.

Smooth Source Color: Default: 0.4, Range: 0 or greater.
The amount to blur the Source clip before scaling the lights. Has no effect if Use Source Color is zero.

Params2:

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.5, 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.5, 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: 20, 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.

Flicker Amp: Default: 0.2, Range: 0 or greater.
The amount of random flickering of the lights.

Flicker Speed: Default: 0.5, Range: 0 or greater.
The speed of random flickering.

Flicker Randomness: Default: 0.7, Range: 0 to 1.
Controls the variability of the flicker. When set to zero, the lights will flicker constantly, with a small amount of random variation. At higher values, the flickering will have longer steady spells, with the occasional large spike.

Chroma Distort: Default: 0.05, 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.

Color Fringing: Default: 0, Range: any.
Color Fringing 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.

Shift Speed: X & Y,   Default: [0 0], Range: any.
Translation speed of the lights. If non-zero, the result is automatically animated to shift at this rate. The result of animated Speed values may not be intuitive, so for variable speed motion it is usually best to set this to 0 and animate the Shift Start values instead.

Shift Start: X & Y,   Default: [0 0], Range: any.
Translation offset of the lights.

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

Invert Mask: Check-box,  Default: off.
If enabled, inverts the mask input so the effect is applied to areas where the Mask is black instead of white.

Mask Type: Popup menu,  Default: Luma .
This setting is ignored unless the Mask input is provided.
Luma: uses the luminance of the Mask input to scale the brightness of the lights.
Color: uses the RGB channels of the Mask input to scale the colors of the lgiths.

Params3:

Mocha: Default: 0, Range: 0 or greater, Shared .
Brings up the Mocha window for tracking footage and generating masks.

Blur Mocha: Default: 0, Range: 0 or greater, Shared .
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, Shared .
Controls the strength of the Mocha mask. Lower values reduce the intensity of the effect.

Invert Mocha: Check-box,  Default: off, Shared .
If enabled, the black and white of the Mocha Mask are inverted before applying the effect.

Show Mocha Only: Check-box,  Default: off, Shared .
Bypass the effect and show the Mocha Mask itself.

Bypass Mocha: Check-box,  Default: off, Shared .
Ignore the Mocha Mask and apply the effect to the entire source clip.

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.
See general info for: Res , On Fields , Redraw , Undo , Load Defaults , Crop , Add Noise , and Use Gamma .


See Also:

RackDefocus
RackDefocusMono
DefocusPrism
RackDfComp
Blur
BlurChannels
BlurChroma
ZDefocus
Convolve
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
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
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
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