AIPS HELP file for TVBOX in 31DEC21
As of Fri Jul 30 20:07:31 2021
TVBOX: Verb to set boxes with TV cursor & graphics display.
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.
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.
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.