AIPS HELP file for DELBOX in 31DEC25
As of Wed Dec 11 9:43:03 2024
DELBOX: Verb to delete boxes with TV cursor & graphics display
INPUTS
GRCHAN 0.0 7.0 Graphics channel to use
GR2CHAN 0.0 7.0 2nd Graphics channel to use
$ Input/output adverbs:
NBOXES $ 0.0 50.0 Number of boxes to set 0 => 1
CLBOX $ -1.0 8192.0 Pixel locations (X,Y) in
$ image of lower left corner
$ and upper right corner of
$ NBOXES windows.
Uses TV cursor to select the image with which the
BOXes are associated (if needed). Other input is from
TV cursor. See HELP REBOX or the terminal (during
execution) for instructions.
HELP SECTION
REBOX
Type: verb
Use: To delete values in the adverb CLBOX using the TV cursor with a
TV graphics display of the CLBOXes as they are being deleted.
The terminal will issue instructions. If there is more than
one image on the TV, the routine asks the user to point out the
image with which to convert the input values in CLBOX to TV
pixels for the initial display of the boxes. The routine
begins in a "search" mode. In this mode, move the cursor to
any lower left or upper right corner of any rectangular box or
the center or any point on the circumference of any circular
box. Then press button A or B to select that box. Or push
button C or D to exit. The selected box will change color. If
that is the box you wish to delete, hit button A and it will
disappear from the screen and the list and the verb will
re-enter search mode. If you do not want to delete the box,
hit buttons B or C to restore the box to the original color and
return to search mode. Hit button D to restore the box and
exit. NOTE: all initial boxes do not need to be visible on the
TV screen (if it is at its full expansion). Only those that
are partly or fully visible may be deleted however.
Input/output adverbs:
GRCHAN......Graphics channel to use for the main display of boxes.
0 -> 3.
GR2CHAN.....Graphics channel to use for boxes that are about to be
deleted. 0 -> GRCHAN+4.
NBOXES......Number of boxes set before hand and the number set
afterwards.
CLBOX.......Input and 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 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.
On input, all must have legitimate values for pixels
in the image although not necessarily currently displayed
on the (full screen) TV.
EXPLAIN SECTION