8.1 Command Line Interface

The IISS command line interface originally served as the primary means for assigning data sets to frames, and setting all parameters which could not be changed interactively during the run of the program. Currently, most parameters can be set via the User Interface. The command line capabilities which continue to be quite valuable are: determining cell window dimensions, and easily specifying overlay image data or text data to be applied across all frames in a cell. The command line also provides a very compact form for specifying numerous images (that share identical dimensions) to be read into the SpreadSheet and shown with default display settings.

8.2 Basic Format

The command line syntax must conform to the following format:

iiss sheet-level-parameters \

cell-level-parameters [to be applied as default for all cells] \

[for each cell, a separate set of arguments can be submitted, in the form:]

-Qrow,col [starts description of cell (row,col) ]\

files [generic format, raw, HDF, etc, or meta-file] \

cell-level-parameters [to override defaults]

Quickstart Example: iiss lena.jpg

8.3 The Sheet Level Parameters

Default values are shown in parentheses.

• -fn font_name font name for all text; any Font Manager name can be used; to get a list of these, run the program $IISS_HOME/bin/list_fm_fonts. (default: Times-Roman)
• -fs num font size in pixels for all text. (default: 24)
• -H name string to be used as the icon name and sheet title; use only non-blank charaters in the name (default icon name: iiss, default sheet title: IISS)
• -kn index color index to use for display of null frames. (default: 4095, which is black)
• -kv index color index to use for display of vacant frames. (default: 4087, which is gray)
• -ke index color index to use for display of invalid (error) frames. (default: 4086, which is pink)
• -ko index color index to use for background of one-channel frames. (default: 4093, which is green)
• -oc r g b overlay color components, expressed as intensities of red, green and blue; each in the range 0 to 255. (default: 255, 150, 0)
• -pm_add boolean TRUE or FALSE: whether PM_ADD24 is to be used when displaying a one-channel image with colormap offset; the alternative approach involves a writemask() call; see the cell level option -a. (default on VGX: TRUE, others: FALSE).
• -q rows columns number of rows and columns of cells (default SpreadSheet size: 2 x 2)
• -ts num text style: 0-plain, 1-shadow, 2-box.
• -T index color index to use for text color (e.g. 0-black, 1-red, 2-green, 3-yellow, 4-blue, 5-magenta, 6-cyan, 7-white); not available for RGB images. (default: 3)
• -v verbose mode (default: not verbose)
• -w x y dimensions for each cell window, in pixels. (default is size of first image in cell A1, or 512 x 512 if no image data is provided)

8.4 The Cell Level Parameters

• -a offset_value integer value to be added to each pixel of a one-channel image before display, to make use of a specific range in the color look-up-table (default: 256)
• -B turn OFF double buffering (default FALSE)
• -c 3 each set of 3 files comprises a 24-bit image, using the first file as the red component, the second as green, and the third as blue
• -f flip image about x axis during read-in (default: FALSE)
• -H bytes number of bytes to skip for header (default: 0)
• -h help (print this usage message)
• -M read file names and file patterns from the submitted meta-file (default: FALSE, so file names are interpreted as data files rather than metafiles)
• -n do not show frame numbers in any cell (default: FALSE)
• -o filename overlay file, containing an image with values 0 and 255 (overlay data dimensions are assumed to be the same as those of the base image) (default: no overlay image)
• -oh size overlay header size (default: 0)
• -of overlay flip (default: FALSE)
• -s x y size of image x and y dimensions (default 512 x 512)
• -t x y text position (default 25, 50)
• -tf filename use named file instead of image file, for text.
• -to offset offset into text file to reach start of text.
• -tl length length of text in file.
• -z x y initial zoom factors along x and y direction; use -1 -1 to make each cell fill the screen; (default zoom: 1 1)