AIPS HELP file for TVCUBE in 31DEC24
As of Tue Nov 12 8:07:04 2024
TVCUBE: Verb to load a cube into tv channel(s) & run a movie
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
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
TXINC 0.0 256.0 Load every TXINC'th column
TYINC 0.0 256.0 Load every TYINC'th row
TZINC 0.0 256.0 Load every TZINC'th plane
TVCHAN 1.0 4.0 Image channel to load with
first frame
DOALL > 0 => loop over multiple
axes if present in the image
PIXRANGE Min,Max of image intensity
0 => entire range
FUNCTYPE Image intensity transfer func
'LN' Linear. unknown=>'LN'
'LG' Logarithmic
'L2' More logarithmic
'SQ' Square root
'NE' Negative linear
'NG' Negative logarithmic
'N2' Negative more log.
'NQ' Negative square root
LTYPE -410.0 410.0 Label type: 1,2 => none,
3 => physical, 4 => rel to
ref pixel, 5 => rel to
subimage center, 6 => pixel
DOCIRCLE -1.0 1.0 <= 0 => reverse direction of
movie at each end
DOPOS -1.0 1.0 > 0 => put a pointer in
each subimage
DOCENTER -1.0 1.0 > 0 => use zoom factor FACTOR
and force TV window to be
centered, workstations only
FACTOR 0.0 16.0 zoom factor to use
HELP SECTION
TVCUBE
Type: Verb
Use: To load a number of subportions of planes of a cube into
the TV memory and then to display them in sequence at
user chosen rates (like a movie). The verb can load up
to NC TV memories with 64 61x61, 16 124x124, 4 250x250,
or 1 510x510 planes of cube, where NC = #TV memories + 1
- TVCHAN. Thus, movies of as many as 256 spectral
channels, for example, may be shown on a TV having 4
memories. TVs with larger screens (in pixels) can do
more. During the movie phase, the cursor X position
controls the movie frame rate, button A starts or stops
the movie, button B reverses the direction of the movie,
button C stops the movie (if needed) and allows color or
black and white enhancement, and button D exits. While
the movie is stopped, the cursor X position controls
which frame is displayed. During image enhancement, the
cursor X position controls the intercept, the cursor Y
position controls the slope, buttons A or B switch
between color and black and white enhancement, button C
reverses the sign of the slope (b & w only), and button D
returns to the movie mode. Use REMOVIE to resume the
movie display without reloading the images. The verb
TVMOVIE is similar to TVCUBE, but it loads the images in
a pattern which is less pleasing to the eye when viewed
altogether and more pleasing when viewed as a movie.
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.
TBLC........The Bottom Left-hand pixel of the subarray of
the map to be displayed. The value (0,0,...)
means take the entire image up to TTRC.
TTRC........The Top Right-hand pixel of the subarray of
the map to be displayed. The value (0,0,...)
means take the entire image from TBLC.
TXINC.......Load every TXINC'th column beginning at TBLC.
TYINC.......Load every TYINC'th row beginning at TBLC.
TZINC.......Load every TZINC'th plane beginning at TBLC.
TVCHAN......Image channel to load with the first frame.
Channels TVCHAN+1,... will be used as needed.
0 => channel 1.
DOALL.......<= 0 -> find the first axis > 2 with multiple pixels
(after application of TBLC and TTRC) and loop
over those pixels included.
> 0 -> find all axes > 2 with multiple pixels (after
application of TBLC and TTRC) and loop over
all pixels included.
PIXRANGE....Min,Max intensity to display. 0 => entire range.
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.
LTYPE.......A label is place in the upper left corner of each
frame if LTYPE > 2. Labelling type, see HELP LTYPE for
details: 3 or 7 = standard, 4 or 8 = relative to ref.
pixel, 5 or 9 = relative to subimage (BLC, TRC) center,
6 or 10 = pixels. 7-10 all labels other than tick
numbers and axis type are omitted. Add n * 100 to alter
the metric scaling.
TVCUBE has very limited space for labels and may not
honor your LTYPE.
If DOALL > 0 and there are in fact multiple axes over
which the task loops, the labels will be simple plane
number (over all planes not just TBLC-TTRC/ZINC).
DOCIRCLE....False (<= 0.0) means to reverse the direction of
the movie each time it hits the end.
DOPOS.......True (DOPOS(1,1) > 0.) means put a pointer in
each frame to show how far through the movie that
frame is.
DOCENTER....If true (> 0), limit the TV window to the size
needed to hold 1 frame zoomed only to a factor of
FACTOR. This is available only on workstations
and can be used to make TVMOVIE run faster.
FACTOR......The zoom multiplication factor: 1 => no zoom, 2 =>
double (linearly) each pixel, 3, 4, 5, ... etc.
FACTORs between 1 and the number of frames across
the full screen are meaningful.
EXPLAIN SECTION