FilmDamage Simulates damaged film with many options, including dust, hairs, stains, scratches, defocusing, flicker, and shake. Each option has a master control and a set of detailed controls for adjusting the look of that type of damage. Inputs: Source:  The clip to be processed.

Parameters:

Stains:   Default: 0.2,  Range: 0 or greater.
The number of stains on each frame. A fractional value is treated as the probability of a single stain appearing on any given frame.

Scratches:   Integer,  Default: 5,  Range: 0 or greater.
Controls the number of scratches on each frame, on average.

Saturation:   Default: 1,  Range: 0 or greater.
Scales the color saturation. Increase for more intense colors. Set to 0 for monochrome.

Scale Lights:   Default: 1,  Range: 0 or greater.
Scales the result by this gray value. Increase for a brighter result.

Offset Darks:   Default: 0,  Range: any.
Adds this gray value to the darker regions of the source. This can be negative to increase contrast.

Dust:   Default: 30,  Range: 0 or greater.
The average number of dust pieces on each frame. A fractional value is treated as the probability of a single dust speck appearing on any given frame.

Hairs:   Default: 2,  Range: 0 or greater.
Number of hairs stuck in the projector gate.

Grain Amp:   Default: 0.1,  Range: 0 or greater.
Scales the amplitude of the film grain that is added to the result. Set this to 0 to disable all grain.

Grain Blur:   Default: 0,  Range: 0 or greater.
The grain is smoothed by this amount. Increase for coarser grain.

Grain Hold:   Popup menu,  Default: Frame.
Indicates how often a new grain pattern should be generated. You will probably only notice a difference between these options if Grain Blur is positive to make the grain size larger than one pixel.

Field:  holds the grain pattern for one field.

Frame:  holds the grain pattern for one frame (2 fields).

3:2 Pulldown at 0:  holds the grain in a 3:2 pulldown pattern with the first pulldown frame at 0. These options are appropriate if your clip was created at 24 fps but is now in 30 fps pulldown form. They will not make sense if your clip is 24P. A 3:2 pulldown pattern repeats every 5 frames, so if frame 1:00:23 is the first frame with field artifacts after three normal frames, then you should specify 3 as the first pulldown frame.

3:2 Pulldown at 1:  holds the grain in a 3:2 pulldown pattern with the first pulldown frame at 1.

3:2 Pulldown at 2:  holds the grain in a 3:2 pulldown pattern with the first pulldown frame at 2.

3:2 Pulldown at 3:  holds the grain in a 3:2 pulldown pattern with the first pulldown frame at 3.

3:2 Pulldown at 4:  holds the grain in a 3:2 pulldown pattern with the first pulldown frame at 4.

Shake Amp:   Default: 0,  Range: 0 or greater.
Amount of vertical shaking to add.

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

Vignette Dark:   Default: 0.1,  Range: 0 to 1.
Vignetting is darkening of the image towards the corners and sides of the image. This parameter controls how much the outer corners of the screen should be darkened (vignetted). 0 gives no vignetting, 1 gives maximum darkening.

Vignt Radius:   Default: 1,  Range: 0 or greater.
Distance from the center to apply the vignette.

Vignt Edge Soft:   Default: 0.5,  Range: 0 or greater.
The width of the vignette's soft edge. Larger values give softer, less visible edges.

Vignt Rel Height:   Default: 0.75,  Range: 0.1 or greater.
Controls the aspect ratio of the vignette ellipse. This should normally be set to the aspect ratio of the image, e.g. .75 for NTSC.

Flicker:   Default: 0.2,  Range: 0 or greater.
Scales the colors of the source clip by different amounts over time for a flickering effect. The pattern of flickering can be random, a periodic wave, or a combination of the two.

Defocus:   Default: 0,  Range: 0 or greater.
Blurs the source clip by different amounts over time to simulate focus problems in the projector. The pattern of defocus can be random, a periodic wave, or a combination of the two.

Params2:

Stain Color:   Default rgb: [0.125 0.06 0].
The base color for stains. The color of each stain will vary slightly from this value.

Dust Color:   Default rgb: [0 0 0].
The base color for dust. The color of each piece of dust will vary slightly from this value.

Stain Details Parameters:

Vary Stains:   Default: 0.2,  Range: 0 or greater.
Amount to vary the stain density from frame to frame.

Stain Negative:   Default: 0,  Range: 0 to 1.
Relative density of stains on the negative versus the print. Set to 1 to stain only the negative, or 0 to stain only the print.

Stain Size:   Default: 1,  Range: 0 or greater.
Scales the width and height of stains.

Stain Opacity:   Default: 0.5,  Range: 0 to 1.
Scales the opacity of the stains.

Dust Details Parameters:

Vary Dust:   Default: 0.2,  Range: 0 or greater.
Amount to vary the dust density from frame to frame.

Dust Negative:   Default: 0,  Range: 0 to 1.
Relative density of dust on the negative versus the print. Set to 1 to apply dust only to the negative, or 0 to apply dust only to the print.

Dust Size:   Default: 1,  Range: 0 or greater.
Scales the width and height of dust.

Dust Opacity:   Default: 0.8,  Range: 0 to 1.
Scales the opacity of the dust.

Tint Lights:   Default rgb: [1 1 1].
Scales the result by this color, thus tinting the lighter regions.

Tint Darks:   Default rgb: [0 0 0].
Adds this color to the darker regions of the source.

Shake Details Parameters:

Shake Frequency:   Default: 1,  Range: 0 or greater.
Scales the frequency of the shaking. Increase for faster shaking with more frequent hops and changes in direction.

Shake Always:   Default: 0.5,  Range: 0 to 1.
Controls how often shaking occurs. If set to 1, the clip shakes constantly. If set to 0, the clip never shakes. Values in between cause the clip to shake some of the time, and to stay still at other times.

Shake Border:   Default: 0.1,  Range: 0 or greater.
Size of the black bar in between frames (the unexposed part of the film).

Motion Blur:   Default: 0.2,  Range: 0 or greater.
Blurs the result proportionally to the amount of shaking.

Shake Jumpiness:   Default: 1,  Range: 0 or greater.
Amount of large-scale, jumpy shaking.

Scratches Details Parameters:

White Scratches:   Default: 0.1,  Range: 0 to 1.
Relative number of white and black scratches. Set to 1 to make all scratches white, or 0 to make all scratches black.

Black Scratch Len:   Default: 10,  Range: 0 or greater.
The length of the black scratches in frames, on average.

White Scratch Len:   Default: 2,  Range: 0 or greater.
The length of the white scratches in frames, on average.

Scratch Width:   Default: 0.15,  Range: 0 or greater.
Width of the average scratch, in approximate NTSC-sized pixels.

Vary Width:   Default: 1,  Range: 0 to 1.
If this is 0 all the scratches will be the same width. Increase to let each scratch have its own width.

Scratch Opacity:   Default: 1,  Range: 0 to 1.
Maximum opacity of the scratches. Setting this to 0 will fade the scratches out.

Gaps:   Default: 0.28,  Range: 0 to 1.
Like real analog scratches, the dust particle creating the scratch sometimes rolls around and the scratch 'skips'. This controls how much that happens.

Gaps Freq:   Default: 120,  Range: 0 or greater.
How often do the scratch gaps occur.

Scratch Rough:   Default: 1,  Range: 0 or greater.
Amount to roughen the edges of each scratch to simulate the random character of a real scratch.

Area Center:   Default: 0,  Range: any.
The center coordinate of the area of the screen covered by the scratches. 0 is in the middle of the screen, -1 is the left edge, and 1 is the right edge.

Area Width:   Default: 1,  Range: 0 or greater.
The width of the area of the screen covered by scratches. 1 means the scratches cover the full screen area. To get scratches only in one strip, adjust area width smaller.

Weave Amount:   Default: 1,  Range: 0 or greater.
How much does each scratch weave around on the screen, on average. This is in frame-widths, so 1.0 will let a scratch wander all over the screen. If set to zero, the scratches will all be straight vertical.

Weave Frequency:   Default: 0.1,  Range: 0.01 or greater.
How fast do the scratches weave around on the screen, in cycles per frame. Normally less than one.

Hair Details Parameters:

Hair Persistence:   Default: 3,  Range: 0.1 or greater.
Controls the length of time that hairs persist, and the frequency with which new hairs appear. Increase this value for long-lived hairs, and decrease it to get new hairs more often.

Hair Wiggle Amp:   Default: 0.1,  Range: 0 or greater.
Controls the amount of random movement and stretching that each hair exhibits.

Hair Wiggle Freq:   Default: 1,  Range: 0 or greater.
Controls the frequency of the hair wiggle.

Hair Size:   Default: 1,  Range: 0 or greater.
Scales the width and height of the hairs.

Hair Opacity:   Default: 1,  Range: 0 to 1.
Scales the opacity of the hairs.

Vary Hair Size:   Default: 1,  Range: 0 or greater.
Amount to vary the size from one hair to the next.

Flicker Parameters:

Flicker Amp:   Default: 1,  Range: 0 or greater.
The amplitude of random brightness flickering.

Flicker Freq:   Default: 10,  Range: 0 or greater.
The frequency of the random flickering. Increase for more variation between frames. Decrease for slower flickering.

Defocus Parameters:

Defocus Amp:   Default: 1,  Range: 0 or greater.
The amplitude of defocusing that changes randomly over time.

Defocus Freq:   Default: 10,  Range: 0 or greater.
Scales the frequency of the random defocus. Increase for more variation between frames. Decrease for slower defocus changes over time.

See Also:

FilmEffect BleachBypass Technicolor2Strip Vignette Flicker JpegDamage ScanLines

FlickerRemove FlickerMatch Shake HueSatBright

Sapphire Plug-ins Introduction

© 2010, GenArts, Inc. All rights reserved.