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 causes 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. 

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. 

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. 

SEE ALSO

fm_load(3G). 

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) in HP-UX Reference for more information. 

Hewlett-Packard Company  —  HP-UX Release 10.0