StreaksMask Motion blurs the bright areas of the source into streaks between the From and To transformations, at non-black areas of the Mask. This can be used to create an extended film exposure effect, or simulate soft beams of light. Inputs: Source:  The clip to be processed. Mask:  The Source is scaled by the values of this input clip before the areas that get streaked are determined. This can be used to selectively remove or reduce the streaks applied to specific areas of the Source.

Parameters:

From Z Dist:   Default: 1,  Range: 0.001 or greater.
The 'distance' of the From transformation. This zooms about the Center location when Shift is 0. Increase to zoom out, decrease to zoom in. This parameter can be adjusted using the From Transfm Widget.

From Rotate:   Default: 0,  Range: any.
The rotation angle of the From transformation, in degrees, about the center. This parameter can be adjusted using the From Transfm Widget.

From Shift:   X & Y,   Default: [0 0],  Range: any.
The horizontal and vertical translations of the From transformation. This can be used for directional motion. If it is non-zero the center location becomes less meaningful. This parameter can be adjusted using the From Transfm Widget.

Center:   X & Y,   Default: [0 0],  Range: any.
The center of rotation and zooming, in screen coordinates relative to the center of the frame. The shift values should be zero for this location to make sense. This parameter can be adjusted using the Center Widget.

Exposure Bias:   Default: 0,  Range: 0 to 1.
Determines the variable amount of exposure along the path between the From and To transformations. A value of 0 causes more exposure at the From end, 0.5 causes equal exposure along the path, and 1.0 causes more exposure at the To end. If you have bright spots on a dark background, a 0 value would cause the processed spots to be brighter at the From end and dark at the To end, and a 1.0 value would cause the opposite.

To Z Dist:   Default: 0.8,  Range: 0.001 or greater.
The 'distance' of the To transformation. Increase to zoom out, or decrease to zoom in. This parameter can be adjusted using the To Transform Widget.

To Rotate:   Default: 0,  Range: any.
The rotation angle of the To transformation, in degrees, about the center. Note that if the From and To Rotate angles are very different, the interpolation between them will become less accurate. This parameter can be adjusted using the To Transform Widget.

To Shift:   X & Y,   Default: [0 0],  Range: any.
The horizontal and vertical translations of the To transformation. This can be used for directional motion. If it is non-zero the center location becomes less meaningful. This parameter can be adjusted using the To Transform Widget.

Mix Src Darks:   Default: 1,  Range: 0 or greater.
The dark non-streaked components of the Source are scaled by this amount and added to the result. This allows combining the streaked and non-streaked versions of the source clip.

Mix Src Brights:   Default: 0,  Range: 0 or greater.
The original bright components of the Source that were used to generate the streaks are scaled by this amount and added to the result. This allows combining some non-streaked bright areas of the source clip with the output.

Scale Streaks:   Default: 1,  Range: 0 or greater.
Scales the brightness of the streaks.

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

Threshold:   Default: 0.5,  Range: 0 or greater.
Streaks are generated from locations in the source clip that are brighter than this value. A value of 0.9 causes streaks at only the brightest spots. A value of 0 causes streaks for every non-black area.

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

Wrap:   Popup menu,  Default: NO.
Determines the method for accessing outside the borders of the source image.

NO:  gives black beyond the borders.

TILE:  repeats a copy of the image.

REFLECT:  repeats a mirrored copy. Edges are often less visible with this method.

Subpixel:   Check-box,  Default: on.
If enabled, uses a better quality but slightly slower method for rendering the streaks.

Streaks Res:   Popup menu,  Default: FULL.
Selects the resolution factor for the streaks. This is similar to the general 'Res' factor parameter, but it only affects the streaks: the original mixed with the streaks remains at full resolution. Higher resolutions give better quality, lower resolutions give faster processing.

FULL:  Full resolution is used.

1/2:  The streaks are calculated at half resolution.

1/4:  The streaks are calculated at quarter resolution.

Combine:   Popup menu,  Default: Add.
Determines how the streaks are combined with the background.

Add:  causes the streaks to be added to the background.

Screen:  performs a blend function which can help prevent overly bright results.

Params2:

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.
Determines how the Mask input channels are used to make a monochrome mask.

Luma:  the luminance of the RGB channels is used.

Color:  The red, green, and blue channels are used.

See Also:

Streaks StreaksComp StreaksMaskCmp

Rays EdgeRays BlurMotion WarpRepeat WarpChroma

Sapphire Plug-ins Introduction

© 2010, GenArts, Inc. All rights reserved.