Name

---

      BOX2B

Purpose

---

      Simple two mouse button interactive box on image display.

Category

---

Calling Sequence

---

      box2b, x1, x2, y1, y2

Inputs

---

Keyword Parameters

---

Keywords

---

        /LOCK lock box to initial size (box must be defined).
        /XMODE use XOR mode for box.
        /STATUS means display box size and position.
          Use FACT=fct to correct for demagged image.
        MENU=txtarr Text array with exit menu options.
          Def=['OK','Abort','Continue']. Continue is added.
        /NOMENU Inhibits exit menu.
        EXITCODE=code. 0=normal exit, 1=alternate exit.
          If MENU is given then code is option index.
        /YREVERSE makes y=0 be the top line.
        FACT=fact Factor to correct image coordinates.
          If an image is dispayed half size give FACT=2 to get
          full size image coordinates (def=1).
        CHANGE=routine Name of a procedure to execute when box
          changed. Do box2b,/ch_details for details.
        CTEXT=txt change routine toggle text for menu.

Outputs

---

      x1, x2 = min and max device X. in, out
      y1, y2 = min and max device Y. in, out
      Set all values to -1 for new box.

Common Blocks

---

Notes

---

      Notes: Works in device coordinates.
        Drag open a new box. Corners or sides may be dragged.
        Box may be dragged by clicking inside.
        Click any other button to exit.
        A returned value of -1 means box undefined.

Modification History

---

      R. Sterner, 1997 Nov 10
      R. Sterner, 1998 Feb 5 --- Fixed first erase box problem.
      Better but not perfect.
      R. Sterner, 1998 Jul 21 --- Added List Box Position.
      R. Sterner, 1999 Mar 15 --- Added /YREVERSE keyword.
      R. Sterner, 2002 Sep 17 --- Fixed initial box erase problem.
      R. Sterner, 2002 Sep 17 --- Also fixed button up move error.
      R. Sterner, 2002 Sep 17 --- Added /XMODE.
      R. Sterner, 2002 Sep 17 --- Added CHANGE procedure option.
      R. Sterner, 2004 Mar 23 --- Made small /locked boxes easier to move.
      R. Sterner, 2005 Oct 13 --- Minor help text addition.
      R. Sterner, 2006 Apr 09 --- Added help on how to get a new box.
      R. Sterner, 2007 Feb 08 --- Fixed to allow abort on first click.
      R. Sterner, 2008 Jun 27 --- Now assumes color image.
      R. Sterner, 2010 Apr 30 --- Converted arrays from () to [].
  Copyright (C) 1997, 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.