TYPE: COP
TITLE: Equalize COP

This operation equalizes colors by stretching the image histogram.
The transform is either a shift or a scale, depending on the fit method.
Several modes are available:

Examples:
    Stretch Range to Black/White - The minimum and maximum values found in
                                   the image are mapped to black
                                   and white, which may result in a contrast
				   adjustment and a luminance shift.
    Move Minimum Value to Black - The values are transformed so that the
                                  minimum value maps to black. 
    Move Maximum Value to White - The values are transformed so that the
                                  maximum value maps to white. 
    Shift Average Luminance     - The global luminance is computed and all
				  values are transformed so that the global
				  luminance matches the specified value.
    Equalize Luminance Across Frames - The global luminance is computed for
				       several frames around the current frame.
				       The current frame's global luminance is
				       transformed to match the average global
				       luminance, effectively removing frame
				       flicker.

Parameters
    Operation           - The equalization operation to perform (see above).
    Fit Method          - The transformation, either a bright scale or shift.
    Luminance           - The method for computing luminance.
    Black               - What value 'black' is defined to be, normally zero.
                          (black & white are independent of black/white points)
    White               - What value 'white' is defined to be, normally one.
    Average Luminance   - The luminance to move the average luminance to.
    Frames Before       - Number of frames before the current frame to
                          analyze (for Equalize Luminance only).
    Frames After        - Number of frames after the current frame to analyze.
    Effect              - The amount of effect equalize has on the image 
                          (0 is none, 1 is full effect).
Mask & Plane Scope, Frame Scope
    Overview - See extra help (Middle click on the dialog '?' help).

Local Variables:
    L   - Sequence length
    S   - Start of sequence
    E   - End of sequence
    IL  - Input sequence length
    SR  - Sequence frame rate
    NP  - Number of planes in sequence
    W,H - Width and height of image
    I   - Image index (0 at start frame)
    IT  - Image time (0 at start frame)
    AI  - Current plane array index
    PI  - Current plane index
    PC  - Num of channels in current plane

See Also: HSV, Limit, Quantize
