Text Strings and Bitmap Icons

Text

You can place many strings of text on the overlay. Use the full ROMAN8 character set. If you wish to include embedded spaces, enclose the string in double quotes (").

You can place text on the overlay in terms of map units, specifying the justification: left, center, right, top, or bottom. The justification remains in effect for all subsequent strings until another justification is specified.

You can also place text on the overlay relative to the edge of the display screen. In these cases, the position is in 10 000 ths of the screen measured from the lower left corner. For example, a location of (5000, 500) is in the middle near the bottom.

Bitmap Icons

The bitmap icons supported by IRIS are black and white icons (.xbm files). Color icons are not supported (.xpm files).

Icons of any size are supported, but using large icons is not practical. If icons are larger than 16 by 16 pixels, they take up too much of the screen.

You can edit icons using the icon editor that comes with the UNIX system.

Once icons are edited in the icon editor, place the xbm files in the $IRIS_OVERLAY directory and overlay files can make reference to them by name.

Statements and Commands

Appearance Statements
Command Description
SIZE # Set the text size in pixels, range 7 ... 26.
HIGHLIGHT Use highlighted text (reverse video).
NORMAL Use normal video text.
Map Unit Justification Statements
Command Description
TOP Text is top-justified.
BOTTOM Text is bottom-justified.
LEFT Text is left-justified.
RIGHT Text is right-justified.
CENTER Text is centered.
Screen-relative Justification Statements
Command Description
SCN_CENTER Text is centered relative to the screen.
SCN_LEFT Text left-justified relative to the screen.
SCN_RIGHT Text is right-justified relative to the screen.
String Location and Content Statements
Command Description
TEXT x y str Places the text str at the specified location.
ICON_TEXT str Same as above TEXT command, but str is placed next to the bitmap icon specified in the most recent ICON command.
TEXT x y str1 str2 Places the text str1 at the specified locations.The text str2 is available in the tabulation key in the display options menu. Generally str1 is a short abbreviation that fits cleanly on the screen and str2 is the full string that is not printed on the screen, but is available in the tabulation.
ICON_TEXT s1 s2 Same as the above TEXT command, but s1 is placed next to the bitmap icon specified in the most recent ICON command.
Icon Command
Command Description
ICON x y name Places bitmap icon specified by name at position x y.