NAME:
  hardim
 PURPOSE: (one line)
  Create a postscript image and/or print from an image.
 DESCRIPTION:

  This program will take an image and create a hard copy image via
  Postscript.  Color tables will work only with a color printer.

  If the plot device is not PS upon entry, this program will temporarily
  switch devices if the file is printed.  If the file is not printed,
  the device is left active and open so that additional information
  can be added to the plot.

 CATEGORY:
  Image display
 CALLING SEQUENCE:
  hardim,image,min,max
 INPUTS:
  image - Input array to convert to a postscript image.
  min   - Input array value to scale to output value of 0.
  max   - Input array value to scale to !d.n_colors-1 (peak color).
 OPTIONAL INPUT PARAMETERS:
 KEYWORD PARAMETERS:
  AUTOSIZE     - Automatic output image size setting:
                    0 - no automatic action (default).
                    1 - resize if too big.
                    2 - make image as large as possible.
  BITS         - Number of output bits for image, default=8.
  CTABLE       - Color table number to use for print.  Default is 0
                   for the B/W lookup table.  If 0, behavior will default
                   to non-color printing.
  DELPOS       - Position offset (x,y) in centimeters for image.
  ENCAPSULATED - Flag, if true ==> generate encapsulate postscript.
                   This will automatically set NOPRINT.
  FILE         - Name of postscript file, default is idl.ps
  LANDSCAPE    - Flag, if true ==> landscape mode output orientation.
                        Default is portrait.
  NEGATIVE     - Invert the color table if set.
  NOCLOSE      - If true, prevents closing the output device in
                    encapsulated mode.
  NOBOX        - When set will suppress the pixel axes around image.
  NOPRINT      - Flag, if true ==> do not send the postscript file to the
                   the printer.  Default to FALSE.
  POSITION     - 2 element vector specifying the location of the lower
                   left hand corner of the image relative to the page
                   setup origin.  The default is to center the image
                   on the page (less 3-hole punch margin).  Values are
                   in centimeters.
  QUEUE        - Name of the print queue to send postscript file to.
                   Defaults to the default printer.
  TITLE        - Title to put over image.
  TRUE_COLOR   - Indicates 24-bit color input image if set, values are
                    1 - pixel interleave (3, width, height)
                    2 - row interleave   (width, 3, height)
                    3 - image interleave (width, height, 3)
                    sets bits=8 automatically.
  XBORDER      - Two element vector with x border to put around image.
                    Values are in cm, default = [0,0], used only for
                    encapsulated output.
  YBORDER      - Two element vector with y border to put around image.
                    Values are in cm, default = [0,0], used only for
                    encapsulated output.
  WIDTH        - Width of image in cm.  Default = 15cm.
 OUTPUTS:
  A postscript file is created.
 COMMON BLOCKS:
 SIDE EFFECTS:
 RESTRICTIONS:
  This program knows about two kinds of printers, HP Laser Jet IIIsi
  and a Tektronix Phaser IIsd color printer.  The color printer is
  known by the queue name of 'chani'.  Error checking is in place to
  make sure the image is not scaled off the page for each device.
  If the queue is not chani, it is assumed to point at an HP printer.

  The print queueing is specific to Unix and Win32.

 PROCEDURE:
 MODIFICATION HISTORY:
  3/3/93, written by Marc W. Buie, Lowell Observatory
  3/15/93, MWB, encapsulated output was forced to be full page, modified
     so that output matches the image size.
  94/10/05, MWB, added DELPOS keyword
  96/01/06, MWB, added support for auto-spool for DOS/Windows
  96/08/24, MWB, added AUTOSIZE
  97/05/29, MWB, changed COLORTABLE to CTABLE and added COLOR keyword.
  2000/10/13, MWB, removed SPAWN in this routine, now calling hardcopy.