TYPE: COP
TITLE: Depth of Field COP

This operation creates a depth-of-field mask, which describes how out of focus
parts of the image are. Combined with a Blur COP with the mask set to M and
"Accurate Blur Mask" on, a depth-of-field blur can be done. This mask can also
used as an input to color correction operations to accentuate an area of
interest.

A point or depth plane must be present in order for this operation to produce
valid results.

This operation is implemented in VEX. For more information on VEX, right click
on the dialog '?' help.

Parameters
    Focus Distance      - The distance where everything is entirely in focus.
    Depth Adjustment    - Increase or decrease the size of the area that
                          will be out of focus. Corresponds to the "depth
                          of focus" on a real camera lens.
    Distance Adjustment - Adds a constant value to the distance (which is not
                          the same as adjusting the focus distance, which
                          adjusts the dropoff as well).
    Default Mask Value  - The mask value to use when a depth-of-field value
                          cannot be computed.
    Operation Mask      - Not used.
    Invert Mask         - Not used.
    Plane Scope         - Not used.

Frame Scope page:
    Overview - Not used.

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: Bump, Fog, Lighting (light), Transform (xform)
