Intermec Trakker T2090, Руководство пользователя

Страница: 69 / 246

im_dbyte_setfont
4-9
4
im_dbyte_setfont
Purpose This function initializes the .DBFS font specified. Any current DBFS font is
disconnected from the display, and the display is cleared. If switching from
“native” font display, the ABC/123 indicator and native mode cursor (if
active) are disabled and the screen cleared. The altered fonts are not
persistent between applications.
Syntax #include "imt209x.h"
IM_STATUS im_dbyte_setfont
(IM_UCHAR
*fontfile,
IM_USHORT glyph_high,
IM_USHORT glyph_wide,
IM_USHORT offset);
IN Parameters
fontfile Pointer to the name of the font file to initialize. A value of 0 causes a
return to native mode and restoration of the ABC/123 indicator and native
cursor to the states they had prior to the first DBFS im_dbyte_setfont() in this
application.
glyph_high Height of the character cell in pixels (ignored when going to
native mode). Values of 1 to 72 are legal, but the 72
nd
row of the display is not
visible.
glyph_wide Width of the character cell in pixels (ignored when going to
native mode). The value must be an integral multiple of 8 between 8 and 120.
The 120
th
column of the display is not visible.
offset Index of the first glyph in the fontfile (in glyphs).
OUT Parameters
None.
Return Value This function returns one of these codes:
IM_SUCCESS Font installed.
IM_INVALID_FILE The file open failed. The font file could not be
found.
IM_INVALID_PARAM_2 Specified height falls outside the acceptable
limits.
IM_INVALID_PARAM_3 Specified width falls outside the acceptable
limits or is not a multiple of 8.