Name

---

      MAGCRS

Purpose

---

      Show a magnified window around given point and wait for a cursor change.

Category

---

Calling Sequence

---

      magcrs, x, y

Inputs

---

Keyword Parameters

---

Keywords

---

        /INITIALIZE Must be done before using or after a
          color table change. Must be done for each different
          window that uses magcrs.
        STATE=state Structure with state information.
          Returned for /INIT. Must give for each call.
          Allows multiple mag cursors for multiple windows.
        MAG=m Mag factor (def=10). On /INIT only.
        SIZE=s Mag window size (def=200). On /INIT only.
        XPOS=xpos, YPOS=ypos Set mag window position. On /INIT only.
        WINDOW=win Specified mag window, else make one.
          Specified window must be expected size. On /INIT only.
        /NOCURSOR means given x,y are dev coord, do not call
          cursor. Returned x,y are /DATA by default.
        /DATA Work in data coordinates (default).
        /DEVICE Work in device coordinates.
        /NORMAL Work in normalized coordinates.
        /VER=ver draw vertical line through cursor.
          return data under it in ver. Must use in /INIT also.
        /HOR=hor draw horizontal line through cursor.
          return data under it in hor. Must use in /INIT also.

Outputs

---

Common Blocks

---

Notes

---

      Notes: Operates like CURSOR,X,Y,/CHANGE, that is
        after each move or a button up or down. Check !mouse
        to find which button was last clicked.
        When finished with mag window remove it:
          wdelete,st.win
        Sets starting point and cursor to given x,y.
        WINDOW keyword allows use in a draw widget. Use /NOCURSOR.
        Examples: magcrs,/init,state=st
                  for i=0,300 do magcrs,state=st,x,y
                  magcrs,/init,state=st,/ver,/hor
                  for i=0,300 do magcrs,state=st,/ver,/hor,x,y
        Use /INIT only for new image or new window.

Modification History

---

      R. Sterner, 1996 Feb 26
      R. Sterner, 1998 Apr 10 --- Added WINDOW keyword, allows use in widget.
      Also added NOCURSOR keyword.
      R. Sterner, 2002 Sep 05 --- Added /VER and /HOR.
      R. Sterner, 2002 Sep 09 --- Made /VER and /HOR use XOR mode.
      R. Sterner, 2002 Sep 22 --- Added XPOS and YPOS.
      R. Sterner, 2003 May 13 --- Upgraded for true color.
  Copyright (C) 1996, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.