% @(#)creategrap.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:27 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      creategrap.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, CREATE/GRAPHICS
%.PURPOSE    On-line help file for the command: CREATE/GRAPHICS
%.VERSION    1.0  12-JUL-1990 : Creation, RHW
%.VERSION    1.1 910308 RHW improved acc. to verification form
%.VERSION    1.3  29-NOV-1991 : an additional parameter, KB
%.VERSION    1.4  02-Jan-1992 : add Xstation name, KB
%.VERSION    1.5  19-Feb-1993 : now we have shadow displays, KB
%----------------------------------------------------------------
\se
SECTION./GRAP
\es\co
CREATE/GRAPHICS	                                             20-JAN-2000  RHW
\oc\su
CREATE/GRAPHICS [graph_id] [graph_spec] [gsize] [Xstation]
	create a graphics window
\us\pu
Purpose:      
           Create a graphics window (using XWindow)
\up\sub
Subject:      
           Graphics
\bus\sy
Syntax:       
           CREATE/GRAPHICS [graph_id] [graph_spec] [gsize] [Xstation]
\ys\pa
           graph_id = single digit identification number in [0,9] for a
              "main" graphics window, or single character in [a,z] for a shadow
              graphics window; defaulted to 0
\ap\pa
           graph_spec = xdim,ydim,xoff,yoff, where xdim and ydim are the sizes
              in x and y, and xoff, yoff the offsets in x and y (lower left
              corner is 0,0);
\\
              or `shadow,refid' for a `shadow' window, where `refid' is the
              id of the graphics window to be shadowed;
\\
              defaulted to 600,480,0,416 (for DEC-windows 624,435,0,416)
\ap\pa
           gsize = no. of graphic line segments saved;
\\
              this parameter is important for the refreshing of the window,
              because only as many line segments can be redrawn as are
              saved internally;
\\
              defaulted to 100000
\ap\pa
           Xstation = name of Xworkstation/Xterminal screen (in X11 syntax)
              on which the graphics window should be created,
\\
              ojo: the `Xstation' and the local display have to be in the
              same visual mode, i.e. either both are set up for TrueColor
              or both are set up for PseudoColor mode!
\\
              defaulted to `default' which indicates the local screen
\ap\sa
See also:     
           CREATE/DISPLAY, DELETE/GRAPHIC, ASSIGN/GRAPHIC
           INITIALIZE/DISPLAY
\as\no
Note:      This command is only available on XWindow workstations.
           Keyword DAZDEVR(11) will hold the graph_id.
\\
           Shadow graphics `shadow' (repeat) all operations on the referenced
           "main" graphics window. They are useful for showing the contents of
           your graphics window elsewhere in the network. There may be more
           than one shadow graphics window for a given reference window.
\\
           Shadow graphics take all input parameters from the referenced
           "main" graphics window, except `Xstation'. Consequently, the
           parameter `gsize' is not used.
\\
           The parameter 'gsize' has no influence on the plotting of lines,
           it's only important for the refreshing of the window.
\\
           When creating a graphics window, this window becomes the `active'
           graphics window which all graphic related commands will act on.
\\
           To navigate among different graphic windows use the command
           ASSIGN/GRAPHIC which will change the currently `active' graphics
           window.
\\
           You have to have access rights and somebody must be logged in if
           you want to use a different Xstation than the one you're sitting at.
\on\exs
Examples:
\ex
           CREATE/GRAPHICS 1 400,200,400,400
            Create a graphics window (id = 1) with an offset of 400 pixels 
            in x,y from the lower left corner and size of 400*200 pixels.
\xe\ex
           CREATE/GRAPHICS P3=120000
            Create a graphics window (id will be defaulted to 0) with default
            offset and size.
\\
            We plan to plot some very large files and want to make sure, that
            everything is redrawn when the window is refreshed.
\xe\ex
           CREATE/GRAPHICS p4=ws4:0.0
            Create graphics window (id will be defaulted to 0) on Xstation
            which has the name `ws4'.
\xe\ex
           CREATE/GRAPHICS a shadow,0 p4=xt65:0.0
            Create shadow graphics window of graphics "main" window 0 on 
            X11-terminal with name `xt65'.
            All operations on graphics window 0 like image plotting, cursor
            movements, etc. are repeated on the shadow graphics window.
\xe \sxe