% @(#)print_imag.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:50 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      print_imag.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, PRINT/IMAGE
%.PURPOSE    On-line help file for the command: PRINT/IMAGE
%.VERSION    1.0  17-OCT-1983 : Creation, KB
%.VERSION    1.1  31-MAY-1991 : Update, KB
%.VERSION    1.2  25-FEB-1992 : Modif for Command Verif, KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
PRINT/IMAGE					   25-MAY-1998  KB
\oc\su
PRINT/IMAGE frame_specs [pixel_specs] [hide_header_flag]
	print image data values
\us\pu
Purpose: 
          Print image data values on device specified via ASSIGN/PRINT.
\up\sy
Syntax:
          PRINT/IMAGE frame_specs [pixel_specs] [hide_header_flag]
\ys\pa
          frame_specs = name of data frame
\\
               or CURSOR if cursor window is used to define the region of the
               displayed frame which will be printed;
\\
               or CURSOR,1 if only one cursor is used for printing single 
               pixels of displayed frame;
\\
               if `frame_specs' set to CURSOR the following parameters are
               ignored
\ap\pa
          pixel_specs = xcoord,noval or xcoord,ycoord,noval or
               xcoord,ycoord,zcoord,noval,
\\
               depending on the number of dimensions of the frame;
\\
               with coords according to the MIDAS standard for coordinates:
\\
                 a) coord = real no.    => world coordinate
\\
                 b) coord = @integer    => pixel coordinate
\\
                 c) coord = "<"         => first pixel coord. (same as @1)
\\
                 d) coord = ">"         => last pixel coordinate;
\\
               or = [xstart,ystart:xend,yend]
\\
               or = tbname,T
\\
                 to use a table `tbname' which must contain the columns
                 :XSTART, :YSTART, :XEND and :YEND defining the windows in the
                 frame which are to be printed, only world coordinates are
                 possible for the window specifications;
\\
               defaulted to print the first 20 values of specified  frame;
               i.e. like  "<,<,20"  for a 2-dim frame
\ap\pa
          hide_header_flag = if set to H, the frame name as well as the lines
               indicating line and pixel no. are suppressed, else not;
\\
               defaulted to N
\ap\sa
See also:
          ASSIGN/PRINT, OUTDISK/ASCII, READ/IMAGE, WRITE/IMAGE,
\\
          STATISTICS/IMAGE, GET/CURSOR
\as\no
Note:  
          PRINT/IMAGE produces the same output as READ/IMAGE on the device
          specified via ASSIGN/PRINT.
\\
          To use the cursor option you have to enter the complete string
          `CURSOR', no abbreviation is possible.
\\
          The `hide_header_flag' is especially useful for producing plain
          ASCII files, containing only the data values, as output.
\on\exs
Examples:
\ex
          PRINT/IMAGE moctezuma 10.0,120.0,24
            Print 24 pixel values of image `moctezuma.bdf' starting at x-world
            coord 10.0 and y-world coord 120.0
\xe\ex
          PRINT/IMAGE moctezuma <,@9,10
            Print 10 pixel values of image `moctezuma.bdf' starting at first
            pixel in the 9th line.
\xe\ex
          PRINT/IMAGE moctezuma [<,@9:@10,@9]
            Same as above (assuming, that a line contains at least 10 pixels).
\xe\ex
          PRINT/IMAGE CURSOR
            Move cursor window to define region on displayed frame and press
            ENTER on cursor board (or "enter button" of the mouse) to print
            all pixel values inside cursor window.
            To terminate press EXIT (right) button of the mouse.
\xe\ex
          PRINT/IMAGE caballo asno,t
            Print pixels of frame `caballo.bdf', the regions are defined in the
            columns :XSTART, :YSTART, :XEND, :YEND of table `asno.tbl'.
\xe \sxe