FM_OPT(3W)
Series 300 and 500 Only
NAME
fm_opt − optimize character generation if possible
SYNOPSIS
int fm_opt(gfd,optmode);
int gfd, optmode;
DESCRIPTION
gfd is an integer file descriptor for an gopened device interface.
optmode
Optimization mode, where 0 means unoptimize and 1 means attempt to optimize.
DISCUSSION
This routine will cause the device driver to use any special hardware and/or routines it has available for displaying characters for the active font. Not all fonts are optimizable. This is completely device dependent; some devices may not support such a thing as optimization so all character generation may be the same speed regardless.
If optimization is unsuccessful, it may be due to lack of internal table space. It may help to release an optimized font and try again.
Note that if the optimize bit is set in the font file, fm_load will call fm_opt, thereby attempting to optimize the font as it is loaded.
Note that only the 1-byte character portion of a HP-15 (2-byte) font will be optimized. The 2-byte character portion will remain bit/pixel in memory and will continue to be expanded to byte/pixel at display time.
HARDWARE DEPENDENCIES
Series 500:
Font manager routines do not support HP-15 (2-byte) fonts on Series 500.
SEE ALSO
DIAGNOSTICS
This routine will return -1 if the operation was unsuccessful (or not possible at this time due to limited resources) or if there is no active font; otherwise, 0 is returned. See errno(2) for more information.
Hewlett-Packard Company — May 11, 2021