NAME:
  findobj
 PURPOSE:
  Locate image changes with 3-plane color overlays
 DESCRIPTION:

 CATEGORY:
  Astronomy
 CALLING SEQUENCE:
  findobj,root,image1,image2,image3,NOCLEAN=noclean
    -or-
  findobj,image1,image2[,image3]

 INPUTS:

  First input format:
     root - String containing the root of the file name (no path).
     image1 - Image number (integer) to load into the red image plane.
     image2 - Image number to load into the green image plane.
     image3 - Image number to load into the blue image plane (default=image2)

  Second input format:
     image1 - File name of image to load into red image plane.
     image2 - File name of image to load into green image plane.
     image3 - File name of image to load into blue image plane (default=image2).

 OPTIONAL INPUT PARAMETERS:

 KEYWORD INPUT PARAMETERS:
  BINFAC  - binning factor for image display, default=1
  EXTEN   - Extension number of subimage to read (default=0, primary)
  NOCLEAN - Flag, if set will suppress the automatic removal of cosmic rays.
              Note: this step can take a very long time if you don't have
              a fast machine.  On an Ultra 1/170 I find I will occasionally
              supress cleaning.
  NOSCALE - Flag, if set suppressing the scaling operation when reading the FITS file
  PATH    - Path where data is to be found, default = current directory
  QUEUE   - Printer queue for hardcopy, default is chani for color and
              office for b/w
  SAVECLEAN - Flag, if set will cause the cleaned image to be saved alongside
              the original image.  The new file will have 'c' appended to the
              root of the file name.

 OUTPUTS:
  No explicit outputs but you are prompted for a final hardcopy in either
    color or black and white.

 KEYWORD OUTPUT PARAMETERS:
  CCUBE   - If provided, this keyword returns a three dimensional byte array
              of the final stacked color cube displayed in window 3.

 COMMON BLOCKS:

 SIDE EFFECTS:

 RESTRICTIONS:
  You must have a 24-bit color display to use this program.

 PROCEDURE:

 MODIFICATION HISTORY:
  97/04/17 - Written by Marc W. Buie, Lowell Observatory
  97/07/11, MWB, added PATH keyword
  98/01/05, MWB, added QUEUE keyword
  98/01/06, MWB, added SAVECLEAN keyword
  98/03/03, MWB, added second input option
  98/03/25, MWB, added EXTEN keyword
  2000/06/06, MWB, added CCUBE keyword
  2007/11/07, MWB, added NOSCALE keyword, fixed a problem with the binfac keyword