>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  BOX2B

BOX2B

BOX2B

Name


      BOX2B

Purpose


      Two button interactive box, can return a position box.

Category


Calling Sequence


      box2b, x1, x2, y1, y2

Inputs


Keyword Parameters


Keywords


        POSBOX=posbox Return a position box (normalized by default).
          Can be used in POSITION=posbox in a PLOT call.
        /DEVICE means return position box in device coordinates.
        DX=dx (x2-x1+1).
        DY=dy (y2-y1+1).
        /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 [].
      R. Sterner, 2012 Apr 11 --- Now returns a position box.
      R. Sterner, 2012 Apr 11 --- Fixed plotted box, was off by 1.
      R. Sterner, 2012 Apr 20 --- Added DX=dx, DY=dy.
  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.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us