Metrologic Optimus R, Programming Manual

Page: 92 / 241

86 "C" Programming Guide For Optimus S/R
3.8.3 Display
fill_rect
Purpose To fill a rectangular area on the LCD.
Syntax void fill_rect (int left, int top, int width, int height);
int left; /* x coordinate of the upper left corner of the rectangle */
int top; /* y coordinate of the upper left corner of the rectangle */
int width; /* width of the rectangle to be filled, in dots */
int height; /* height of the rectangle to be filled, in dots */
Example fill_rect (12, 8, 40, 8);
Description This routine fills a rectangular area on the LCD whose top left position and size
are specified by left, top, width, and height. The cursor position is not affected
after the operation.
Return None
See Also clr_rect
ICON_ZONE
Purpose To enable or disable the printing of characters in the icon area.
Syntax void ICON_ZONE (int mode);
int mode; /* 1 for printing enabled; 0 for printing disabled (default) */
Example ICON_ZONE (1);
Description
The icon zone refers to an area on the LCD that is reserved for showing status
icon, such as the battery icon, alpha icon, etc. By default, the icon zone cannot
show characters and is accessed by graphic commands only.
The value of the parameter
mode
can be one of the following:
ICON_ZONE_DISABLE (0) : Show status icons by default
ICON_ZONE_ENABLE (1) : Show characters
Display of 128x64 dots (Optimus R)
The icon zone occupies the right-most 8x64 dots. When ICON_ZONE is
enabled, the display can show up to 8 lines * 21 characters for 6x8 font, or 4
lines * 16 characters for 8x16 font.
Display of 100x64 dots (Optimus S)
The icon zone occupies the right-most 4x64 dots. Yet, 4 pixels' width
cannot hold one character. Therefore, even when ICON_ZONE is enabled,
the display remains to show up to 8 lines * 16 characters for 6x8 font, or 4
lines * 12 characters for 8x16 font.