TYPE: COP
TITLE: Defocus COP

This operation defocuses an image similar to a real camera defocus. Unlike 
blur, it flares the pixel outwards equally. The shape of the flare can be
circular, or that of a regular polygon, to model different types of lenses.

Because computer images tend to have extremely bright spots clipped at white, 
you can boost values above a certain threshold so that they appear brighter 
than they actually are, mimicking the defocus circles of a bright light 
source. 

Parameters:
    Defocus         - The amount of defocusing to apply (in pixels).
    Defocus Y       - If you would like to specify the defocus in the vertical
                      direction separately, toggle on this parameter (useful
                      for getting a motion blur defocus effect).
    Defocus Shape   - The shape of the lens's circle of confusion.
    Polygon Edges   - If the defocus shape is a polygon, this is the number of
                      edges that the regular polygon has.
    Lens Rotation   - If the defocus shape is a polygon, you can rotate the
                      polygon shape to any orientation.
    Add Edge Ring   - Adds a brighter ring area around the defocused area, to
                      mimic a real lens.
    Ring Size       - The portion of the defocused area that will be visible
                      as a bright ring (its proportional thickness). 0 is none,
                      1 is the entire area. Normally the ring is only a small
                      portion of the defocused area (around 5%, or 0.05). 
    Ring Intensity  - The extra brightness of the ring (0 is none). 
    Ring Offset     - The ring can be biased more to one side of the bloom; 
                      a negative value shifts the bloom ring left or down, 
                      while a postiive value shift the bloom ring right or up. 
    Boost Intensity of Bright Spots - If on, values about a certain threshold
                                      are brightened to produce visible 
                                      circles.
    Boost Threshold - All luminances above this value will be boosted.
    Boost Factor    - Multiplies the luminance above the threshold to produce
                      the boost. Produces a more gradual boost.
    Boost Level     - Boosts the luminance above the threshold amount by this
                      value (by adding it to the luminance). Produces more
                      abrupt changes in color, making the defocus shape
                      stand out more from the image.

Mask & Plane Scope, Frame Scope page:
    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
