% @(#)createcurs.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:27 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      createcurs.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, CREATE/CURSOR
%.PURPOSE    On-line help file for the command: CREATE/CURSOR
%.VERSION    1.0  11-JAN-1994 : Creation from createaux_.hlq, KB
%----------------------------------------------------------------
\se
SECTION./CURS
\es\co
CREATE/CURSOR			        	  05-JUL-1995  KB
\oc\su
CREATE/CURSOR [dspid] [wind_specs] [Xstation]
	create a cursor window
\us\pu
Purpose: 
          Create a cursor window for an existing display window.
\up\sub
Subject:
          Image Display
\bus/sy
Syntax: 
          CREATE/CURSOR [dspid] [wind_specs] [Xstation]
\ys\pa
          dspid = display identification of main (connected) display window;
\\
              defaulted to 0
\ap\pa
          wind_spec = xdim,ydim,xoff,yoff of cursor window;
\\
              defaulted to 180x180 pixels
\ap\pa
          Xstation = name of Xworkstation/Xterminal screen (in X11 syntax)
             where the cursor window should be created;
\\
             defaulted to the screen where the main display window is
\ap\sa
See also:
          DELETE/CURSOR, CREATE/ZOOM, DELETE/ZOOM,
\\
          CREATE/DISPLAY, CREATE/GRAPHICS, GET/CURSOR
\as\no
Note:  
          This command is only available on XWindow workstations.
\\
          If a cursor window has been created all subsequent cursor
          readings from the main display window will show in the cursor
          window a 9x9 area around the cursor \#0 (i.e. the mouse) zoomed up
          by a fctor of 20. This cannot be changed by the values xdim,ydim 
          of the parameter `wind_spec', just the window size changes!
\\
          The display window for which we want to create a cursor window
          must be currently active!
\on\exs
Examples:
\ex
          CREATE/CURSOR  
            Create a cursor window for the curently active display window.
\xe\ex
          CREATE/CURSOR  1 ? lw7:0.0
            Create a cursor window for the window with display id = 1
            on screen named lw7:0.0 .
\xe\sxe