NAME:
    cw_itool
 PURPOSE:
    General purpose image display.
 DESCRIPTION:
 CATEGORY:
    Compound Widgets
 CALLING SEQUENCE:
    result = cw_itool( parent )
 INPUTS:
    parent : The parent application base (Should be a Top Level Base).
 OPTIONAL INPUT PARAMETERS:
    image : The image array to be displayed.
 KEYWORD PARAMETERS:
  FVISIBLE       :  Size of the full-view window (128 pixels).
  NODISMISS      :  If set, the Dismiss button is not sensitive.
  PHOTPARMFILE   :  Optional photometry parameters file.
  TMPLFILE       :  Optional Photometry template file.
  XSIZE          :  The image X-size (required).
  YSIZE          :  The image Y-size (required).
  WXVISIBLE      :  Creates work window with explicit x-size (500).
  WYVISIBLE      :  Creates work window with explicit y-size (500).
  WZOOMFACT      :  Ceiling for work-view zoom factor (unlimited).
  ZVISIBLE       :  Size of the zoom window (128 pixels).

 OUTPUTS:
 OPTIONAL OUTPUT PARAMETERS:

 COMMON BLOCKS:

 SIDE EFFECTS:

 RESTRICTIONS:

 proCEDURE:

 MODIFICATION HISTORY:
    Written by Doug Loucks, Lowell Observatory, June 1994.
    This version is a major re-write, employing the compound widget design
 introduced in Version 3 of IDL.
 94/10/27, MWB, Lowell Observatory, fixed ZOON bug on line 1144.
 95/01/24, MWB, xcen,ycen size mismatch storing back to template if array is
           3-d.  Fixed to copy *last* position from Basphote return.
 95/06/12, MWB, Fixed bug in stretch range computation for large cubes of
           small images.
 95/09/07, MWB, Changed auto-stretch computation to make it more robust.
 95/10/31, MWB, Fixed widget layout problem caused by IDL v4.0 changes.
 96/01/06, MWB, Changed W*VISIBLE default to recognize smaller screens.
 96/01/16, MWB, Fixed !order=1 bug in mouse event handling.
                Fixed Stretch Menu operational bugs for handling image cubes.
 96/06/25, MWB, Added autophot support
 97/12/12, MWB, changed display to include more image info on main window.
 99/08/31, MWB (with help from John Mattox), added a
               feature that overplots the aperture on the zoom window
               image after template or single-object photometry measurement.
 2001/4/3, MWB, added plotting of active template in work window
 2001/9/18, MWB, fixed color error in plots with 8-bit display.
 2002/11/17, MWB, fixed !order=1 bug for overplotting templates.
                  Replaced image scaling with updated skysclim routine.