AIPS HELP file for TVROAM in 31DEC25
As of Mon Dec 9 12:52:01 2024
TVROAM: Verb to load up to 16 planes and roam a subset thereof
INPUTS
INNAME Image name(name).
INCLASS Image name(class).
INSEQ 0.0 9999.0 Image name(seq. #). 0=>high
INDISK 0.0 9.0 Disk drive #. 0=>any
ROMODE 0.0 1616.0 # planes on X*100 plus #
planes on Y
TXINC 0.0 256.0 Load every TXINC'th column
TYINC 0.0 256.0 Load every TYINC'th row
TBLC 0.0 4096.0 Bottom Left Corner of image
0=>entire image
TTRC 0.0 4096.0 Top Right Corner of image
0=>entire image
PIXRANGE Min,Max of image intensity
0=>entire range
TVCHAN 0.0 16.0 TV channel for LUT
TVCORN 0.0 512.0 TV pixel location of bottom
left corner of image
FUNCTYPE Image intensity transfer func
'LN' Linear. blank=> 'LN'
'LG' Logarithmic
'L2' More logarithmic
'SQ' Square root
'NE' Negative linear
'NG' Negative logarithmic
'N2' Negative more log.
'NQ' Negative square root
HELP SECTION
TVROAM
Type: Verb
Use: Loads an image to a number of TV memory planes in such a way
that a "roam" operation may be performed. After loading, it
goes into roam using the TV cursor position to determine which
contiguous NXxNY piece of the image is currently visible on the
screen. NX and NY depend on the model of TV or on the TV server
and X11 server. Pressing button A enhances the black-and-white
transfer function for all channels. In the enhance mode,
pressing button C reverses the slope of the enhancement and the
other buttons return you to roaming. Pressing button B in roam
causes the zoom to increment (in a circular fashion), button C
causes the zoom to decrement, and buttom D causes an exit. You
may use verbs like IMXY, IMPOS, etc., on the "split screen"
image after exiting the roam mode. You may not not use TVLABEL,
TVZOOM, TVSCROL, etc., until you have turned on only one channel
(use verb ROAMOFF). See EXPLAIN TVROAM for further details.
TV channels 1 through M are used, where M = Mx times My with Mx
the number of frames in the x direction and My the number of
frames in the y direction (set by ROMODE or defaulted). With
the rebuilt XAS, M must be <= 16. TVTRANSF with TVCHAN=0 will
work on all M channels when the screen is in roam mode, not just
the 4 that are visible. You may now do this enhancement while
roaming as well.
Adverbs:
INNAME......Image name(name). Standard defaults.
INCLASS.....Image name(class). Standard defaults.
INSEQ.......Image name(seq. #). 0 => highest.
INDISK......Disk drive # of image. 0 => any.
ROMODE......One hundred times the number of planes on the X axis
plus the number of planes on the Y axis
(ROMODE = 100 * Mx + My).
0 => program figures "best" arrangement.
TXINC.......Load every TXINC'th column beginning at TBLC.
TYINC.......Load every TYINC'th row beginning at TBLC,
TBLC........The Bottom Left-hand pixel of the subarray of the map to
be displayed. The value (0,0,...) means take the entire
first plane of the image.
TTRC........The Top Right-hand pixel of the subarray of the map to
be displayed. The value (0,0,...) means take the entire
plane of the image.
PIXRANGE....Min,Max intensity to display. 0 => entire range.
TVCHAN......The look-up-tables of channel TVCHAN are propogated to
all channels of the roam display at the beginning. If
the image does not need roam, TVCHAN is the channel to
which the image is loaded. 0 -> 1
TVCORN......TV pixel location (X,Y) of the bottom left-corner of the
image. 0=>center on TV (recommended)
FUNCTYPE....Image intensity transfer function
'LN' => linear; 'NE' => negative lin.
'LG' => log; 'NG' => negative log;
'L2' => extreme log; 'N2' => negative extra log;
'SQ' => square root,; 'NQ' => negative square root;
others => linear.
EXPLAIN SECTION
ROAM
Type: A form of TV display operation
Use: When an image is too large to fit in one TV memory plane, it is
possible to load portions of the image into more than one TV
memory. Then, one may view any contiguous Nx x Ny portion of
the image, where Nx and Ny depend on the model of TV, both 512
for IIS Model 70 and both 1024 for the IVAS. As coded, during
a "roam" operation, you may use the trackball position
interactively to set which portion of the image is viewed. In
addition, each use of buttons B will increment the
magnification. Use of button C will decrement the
magnification. Button D causes the roam operation to cease,
but leaves the viewed image undisturbed. Button A causes you
to enter a familiar black-and-white transfer function
enhancement of all channels in the roam. While in that mode,
button C reverses the slope of the transfer and buttons A, B,
and D return you to roaming.
How: The TV screen is "split" into portions vertically and/or
horizontally. In each portion only one image plane is visible.
Suitable control of the split point, the scrolls of the images,
and the zoom allow the program to perform the roam. NOTE: many
other TV functions are designed to work only on a single image
and will not work normally on the split-screen image. These
include TVLOD, TVLABEL, TVZOOM, TVFIDDLE, TVSCROLL, TVWINDOW,
TVLABEL, TVBLINK, and slice plotting. Verbs such as IMPOS,
TVNAME, TVPSEUDO, and OFMGET will work.
Verbs:
TVROAM....Load image to TV channels, then roam
REROAM....Roam using previous channel spatial configuration
ROAMOFF...Captures current visible screen as simple screen
image (not in roam mode).
Adverb:
ROMODE....Specify number frames in x and y as 100 * Mx + My.