AIPS HELP file for TVROAM in 31DEC09
As of Sun Nov 22 17:12:29 2009
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/Y axes
See HELP ROMODE.
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
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 buttons A or B 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.
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......Ten 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.
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 A or 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.
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.