Dither

Quick Reference to Scripting Command
a=DITHER(x, y, amount, seed, MONOCHROME)
Items in CAPS are 0/1 switches or switches with more options than 0/1.

Operation Example

The Dither operation allows you to create a random dithering effect in the selected area. You can control the maximum size of a dither region, and the amount of dithering in the selected area.

Dither Operation Dialog

Dither Controls

Trends

You will notice that all of the controls have a Trend button next to them. The trend button allows you to set that variable over a set of frames. Each frame of the animation can be thought of as a slice of time. The trends allow you to alter some, all, or none of the variables for a particular time slice. You will notice that the trend graphs have equidistantly spaced vertical lines. Each of these lines represents a frame in the animation. The number of frames can be altered using the Sequence controls... in the Timeline pull down menu. Animation lengths of 100 - 999 frames will be represented with a vertical bar being 10 frames, and animation length greater than 1000 frames will have a vertical bar for every 100 frames. Click here to view more information on Trends.

Width

This control allows you to specify the maximum width of a dither region. The width is measured in pixels and can range from 1 to 100 pixels. The width is set using the slide gadget or by entering the appropriate value in the text entry field.

Height

This control allows you to specify the maximum height of a dither region. The height is measured in pixels and can range from 1 to 100 pixels. The height is set using the slide gadget or by entering the appropriate value in the text entry field.

Amount

The Amount control allows you to specify the degree of the Dither effect in the selected region. The Amount is a percentage value that ranges from 1% to 100%. A setting of 100% would result in the maximum amount of dithering in the selected region. A setting of 1% will result in the minimum amount of dithering in the selected region. This control is set by using the slide gadget or by entering the desired value in the provided text entry field.

Seed

The Seed setting allows you to alter the random number variable for the Dither operation. Altering this value will result in an alternate dither pattern for each seed value. The Seed parameter ranges from 0 to 9999, but it can set to higher values for Timelines.

Keep Gray

This control, when selected, will allow for gray scale dithering in the selected region. This means that all of the dither regions will be in gray instead of color. If it is not selected, then there will be no gray in the dither colors.

WinImages F/x Manual Version 7, Revision 5, Level B