ILABEL(1)

NAME

ilabel - label an Silicon Graphics image with arbitrary text

SYNOPSIS

ilabel [ -f ] [ -i labels_in_file ] [ -o labels_out_file ]
image_file

DESCRIPTION

ilabel displays the given Silicon Graphics image_file and lets the user put labels over the image. The Silicon Graphics image file may be generated by scrsave(1), imgsnap(1), or some other program, such as conic(1L), that uses the Silicon Graphics Image Library. The labels are drawn using the Silicon Graphics GL Font Manager, which supports many fonts in arbitrary sizes. Labels may be saved to a file for reuse via the -o flag. The stored attributes of labels include color, vertical and horizontal justification, font, size, and position relative to the image. The saved label files may be displayed again using the -i flag. There may be several -i files but at most one -o file. The output file is created when the user selects Exit from the pop-up menu. If the file already exists, the user is asked whether the file should be overwritten (unless the -f flag was specified, in which case no question is asked). You can also save labels before exiting by choosing Save Labels off the pop-up menu. If you do this, you will be prompted for a file name whether or not you specified -o on the command line. You can save a new image with the labels embedded in it by choosing Save Image from the pop-up menu. You will be prompted for a file name. Note that if you intend to use the itops(1) utility to print the image, it is better to save the labels in a separate file rather than embedded in the image, since the quality of the labels will then be limited by the resolution of the printer rather than the resolution of the image. Labeled images can be converted to printable PostScript files with the itops(1) utility provided with the MidasPlus distribution. It is necessary to use the -L flag of itops in order to have the labels placed on the image.

To add a new label, simply click the left mouse button, which should make a triangular cursor appear, and type in the label. Labels containing multiple lines may be created by typing either RETURN or LINEFEED at the appropriate place. The left button is also used to select other labels so that they may be edited. The middle button is used to select and move labels. The right button displays a menu which contains options to show and hide the defaults panel (see below), redraw the images and labels, save the current labels in a file, save the current image, turn the mouse cursor on and off, and quit.

The default display attributes for labels are as follows:

font      Times Roman
size      14
color      white justification bottom left

All these values may be changed via the defaults panel, which is shown when the user selects the Show Defaults option from the right-button menu. When the mouse cursor is over the defaults panel, the left mouse button is used to select the justification mode and label color; the font size may be changed by typing the size and then RETURN (no cursor is shown); and new fonts may be selected from the right- button menu. Also, colors may be selected from anywhere on the screen. If the mouse button is depressed over the color selection area, the mouse may be moved anywhere and a color will not be selected until the button is released.

SEE ALSO

conic, itops, label3d, snapshot

BUGS

Cannot display arrows.

AUTHOR

Conrad Huang
UCSF Computer Graphics Laboratory