AIPS HELP file for TVBOX in 31DEC24

As of Fri Apr 26 22:19:50 2024

INPUTS

          Input is from TV cursor.  See HELP TVBOX or the
          terminal (during execution) for instructions.
         @        Output adverbs
NBOXES   @    0.0           50.0   Number of boxes to set 0 => 1
CLBOX    @   -1.0         4096.0   Pixel locations (X,Y) in
         @                         image of lower left corner
         @                         and upper right corner of
         @                         NBOXES windows.

HELP SECTION

TVBOX
Type:  verb
Use:   To set values in the adverb CLBOX using the TV cursor with a TV
       graphics display of the CLBOXes as they are being set.  The
       terminal will issue instructions.  While setting the lower left
       corner of each box for the first time, buttons A and B will mark
       the corner and switch to setting the upper right corner of the
       box.  Button C will change the rectangular box to a circular one
       and button D will exit.  Similarly, while first setting the
       center of a circular box, buttons A and B switch to setting the
       radius, C switches back to a rectangular box, and D exits
       deleting that incomplete box.  While setting or re-setting the
       upper right corner or radius of the box or re-setting the lower
       left corner or center, button A marks the current corner and
       switches to the other corner (or marks and switches between
       radius and center), button B marks the current corner and
       switches to the next (new) box, button C marks the current corner
       and switches to a search mode leading to the resetting of a
       previous box, and button D exits keeping the current and previous
       boxes with their current settings.  In search mode, move the
       cursor to any lower left or upper right corner of any already set
       rectangular box or the center or any point on the circumference
       of an already set circular box and press button A or B to reset
       that corner or push button C to go on to the next box.  As usual
       button D exits.  The number of boxes is set by this verb.  NOTE:
       verb REBOX may be used to reset the results if needed.
Adverbs:
  NBOXES......Number of boxes set.
  CLBOX.......Output adverb: CLBOX(a,1:NBOXES) where a=1 is lower left x
              pixel, a=2 is lower left y pixel, a=3 is upper right x
              pixel, and a=4 is upper right y pixel.  For circular
              boxes, a=1 is -1, a=2 is the radius in pixels, a=3 is the
              center x pixel and a=4 is the center y pixel.

EXPLAIN SECTION