LensFlareMask

In the S_LensFlareMask Plugin.

Renders a lens flare image over the background clip, aligning various flare elements between the hotspot and pivot locations. Obscures or colorizes the flare based on a mask clip.

Inputs:

Back:  The clip to use as background.

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

Parameters:

Hotspot:   X & Y,   Default: [200 300],  Range: any.
The location of the brightest spot in the flare in screen coordinates. It can be set by enabling and moving the hotspot widget. The hotspot parameter is ignored if the AutoTrack effect option is selected.

Pivot:   X & Y,   Default: [0 0],  Range: any,  Shared.
The elements of the flare will be in a line between the Hotspot and the Pivot locations. The Pivot is in screen coordinates relative to the center of the frame.

Scale Widths:   Default: 1,  Range: 0 or greater,  Shared.
Scales the sizes of all the flare elements. This parameter can be adjusted using the Scale Widths Widget.

Rel Heights:   Default: 1,  Range: 0 or greater,  Shared.
Scales the vertical dimension of all the flare elements, making them elliptical instead of circular. This can also be adjusted using the Scale Widths Widget.

Brightness:   Default: 1,  Range: 0 or greater,  Shared.
Scales the brightness of all the flare elements.

Hotspot Bright:   Default: 1,  Range: 0 or greater,  Shared.
Scales the brightness of the hotspot elements only.

Rays Brightness:   Default: 1,  Range: 0 or greater,  Shared.
Scales the brightness of the ray elements only.

Gamma:   Default: 1,  Range: 0 or greater,  Shared.
Increasing gamma brightens the flare, and especially boosts the darker elements.

Saturation:   Default: 1,  Range: any,  Shared.
Scales the color saturation of the flare elements. Increase for more intense colors. Set to 0 for a monochrome lens flare.

Hue Shift:   Default: 0,  Range: any,  Shared.
Shifts the hue of the flare, in revolutions from red to green to blue to red.

Lens:   Popup menu,  Default: 50 300mm Zoom.
The type of lens flare to apply. Custom lens flare types can also be made, or existing types modified, by editing the "s_lensflares.text" file.
50 300mm Zoom:  hotspot with ray cluster, red glow and red ring, and many other elements.
35mm Prime:  hotspot with ray cluster, red glow and red ring, and a few other elements.
105mm Prime:  hotspot with ray cluster, blue ring, blue glow, and other elements.
Anamorphic 1:  horizontal blue rays, diagonal blue ray, red glow and red ring.
Anamorphic 2:  horizontal blue rays and red glow.
Anamorphic Blue:  horizontal and diagonal blue rays with hexagonal blue/white glow.
Rays Only:  ray cluster with no other flare elements.
Rays Only 2:  ray cluster like 105mm_prime, but with no other flare elements.
Rays Only 3:  ray cluster like anamorphic1, but with no other flare elements.
Simple Hex:  four simple red and blue hexagon elements.
Blue Star Burst:  many long blue rays with a white-hot center and various reflection elements.
Orange Rays 6:  orange star with six rays and other elements.
California Sun:  yellow-orange hotspot with long soft double rays and reflection ring.
Space Telescope:  four pointed star with halo.
Red Laser:  intense red rays.
DVcam Vertical:  vertical CCD burnout effect.
White Sun:  white cluster of many rays with a rainbow reflection.
Hex Reflections:  bright center and rays with many blue-green reflection elements.
Diffraction Star:  six pointed white star with rainbow colored rays for a diffraction look.
Diffraction Rays:  white star with many rainbow diffraction rays.
Diffraction Rings:  multiple rings of textured rainbows around a hotspot.
Chroma Ring:  textured rainbow ring that scales with distance between hotspot and pivot.
Chroma Arc:  textured rainbow arc that scales with distance between hotspot and pivot.
Chroma Arc 2:  double rainbow arcs that scale with distance between hotspot and pivot.
Glint Rays:  similar to the default settings of Glint.

Color:   Default rgb: [1 1 1],  Shared.
Scales the color of all flare elements.

Hotspot Color:   Default rgb: [1 1 1],  Shared.
Scales the color of the hotspot elements only.

Other Brightness:   Default: 1,  Range: 0 or greater,  Shared.
Scales the brightness of all flare elements that are NOT at the hotspot location.

Blur Flare:   Default: 0,  Range: 0 or greater,  Shared.
If positive, the flare image is blurred by this amount before being combined with the background.

Scale Back:   Default: 1,  Range: 0 or greater,  Shared.
Scales the brightness of the background before combining with the flare. If 0, the result will contain only the flare image over black.

Combine:   Popup menu,  Default: Screen.
Determines how the flare image is combined with the Background.
Screen:  performs a blend function which can help prevent overly bright results.
Add:  causes the flare image to be added to the background.

Tint Back Whites:   Check-box,  Default: off,  Shared.
If this is enabled, the chroma of the flare is added only after the result is clamped to the maximum brightness. This allows the color of the flare image to still be visible even over bright white backgrounds. For the majority of backgrounds there will be no observable difference.

Params2:

These parameters allow further adjustment of the hotspot, and enabling of the screen interface widgets.

Rays Rotate:   Default: 0,  Range: any,  Shared.
Rotates the ray elements of the lens flare, if any, in counter-clockwise degrees.

Rays Num Scale:   Default: 1,  Range: 0 or greater,  Shared.
Increases or decreases the number of rays.

Rays Length:   Default: 1,  Range: 0 or greater,  Shared.
Adjusts the length of the rays without changing their thickness, or changing the size of the other flare elements.

Rays Thickness:   Default: 1,  Range: 0 or greater,  Shared.
Adjusts the thickness of the individual rays within the flare.

Other Width:   Default: 1,  Range: 0 or greater,  Shared.
Scales the width of all flare elements that are NOT at the hotspot location.

Other Color:   Default rgb: [1 1 1].
Scales the color of all flare elements that are NOT at the hotspot location.

Hotspot Shift:   X & Y,   Default: [0 0],  Range: any,  Shared.
Adds this amount to the hotspot location. This can be helpful if you want the hotspot to follow tracker data.

Negate Shift:   Check-box,  Default: off,  Shared.
If enabled, the hotspot shift parameter is negated before affecting the hotspot.

Add Brightness:   Default: 0,  Range: 0 to 1.
Adds to the brightness of the flare regardless of the mask brightness at the hotspot. Use this parameter to give the flare a minimum brightness even where the mask is black, or to increase the brightness overall.

Blur Mask:   Default: 0.02,  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: Color.
This setting is ignored unless the Mask input is provided.
Luma:  uses the luminance of the Mask input to scale the brightness of the flares.
Color:  uses the RGB channels of the Mask input to scale the colors of the flares.

See general info for: Res, On Fields, Redraw, Undo, Load Defaults, Crop, Add Noise, and Use Gamma.


See Also:

LensFlare
Glint
Glare
Sapphire Plug-ins Introduction


© 2010, GenArts, Inc. All rights reserved.