% @(#)assigndisp.hlq	19.1 (ESO-IPG) 02/25/03 14:02:57 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      assigndisp.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, ASSIGN/DISPLAY
%.PURPOSE    On-line help file for the command: ASSIGN/DISPLAY
%.VERSION    1.0  12-OCT-1983 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./DISP
\es\co
ASSIGN/DISPLAY						04-JAN-1991  KB
\oc\su
ASSIGN/DISPLAY [dev] [file_name]
	define output device for display
\us\pu
Purpose: 
          Define output device for displaying images.
\up\sy
Syntax: 
          ASSIGN/DISPLAY [dev] [file_name]
\ys\pa
          dev = display device (may be shortened to the first 3 characters):
\\
              DISPLAY or D,display_id in X11 environment, display_id in [0,9];
\\
              VERSATEC (only supported under VMS);
\\
              LASER for grayscale Postscript laser;
\\
              COLOUR for colour Postscript laser;
\\
              SLIDE for colour film recorder;
\\
              FILE, if output should go to file indicated in next parameter;
\\
              defaulted to DISPLAY
\ap\pa
          file_name = name of file where to store the image in, only if 
              parameter 'dev' is set to FILE
\ap\sa
See also:
          ASSIGN/PRINT, ASSIGN/DEFAULT, LOAD/IMAGE, COPY/DISPLAY
\as\no
Note:   
          The display assignment will be used in subsequent LOAD/IMAGE and
          LOAD/ITT commands.
\\
          Instead of the generic device names you can also use the system 
          name of a hardcopy device at your site directly. 
\\
          For example, at ESO "ps2usr1" would be possible.
\\
          The actual devices accessed via the generic names LASER, COLOUR
          and SLIDE depend upon how MIDAS was installed at your site.
\\
          Use the command "HELP [Printers]" to get a detailed list of all
          actually available hardcopy devices at your site.
\on\exs
Examples:
\ex
          ASSIGN/DISP colour
            Assign the "default" colour laser printer as image output device.
\xe\ex
          ASSIGN/DISP D,2
            Assign display window 2 as image output device (assuming a X11
            workstation as image display).
\xe\ex
          ASSIGN/DISP FILE display
            Subsequent LOAD/IMAGE command will fill the file `display.bdf'.
\xe\ex
          ASSIGN/DISP ps2usr1
            Assuming that you have a grayscale Postscript printer at your site
            with the name "ps2usr1", this defines ps2usr1 as output device.
\xe\sxe
