Series 300 and 500 Only

NAME

fafontload − load a font into the user’s font cache and prepare it for activation

SYNOPSIS

int fafontload(gfd,path);
int  gfd;
char *path;

DESCRIPTION

gfd is an integer file descriptor for an gopened device interface. 

path is the path name of the font to be loaded. 

DISCUSSION

This routine loads a font into the user’s cache of available fonts. Any of these fonts are ready to be activated as needed.  A system-wide unique font id is returned unless gfd or path are invalid, in which case  -1 is returned.  Like fm_fontload(3W), fafontload automatically makes the font active when it is loaded.  Note that font manager and fast alpha font ids are the same and can be used with both fast alpha and font manager routines. 

This routine will try to optimize the font if the font file header block indicates to do so. 

HARDWARE DEPENDENCIES

Series 500:
Fast alpha routines do not support HP-15 (2-byte) fonts on Series 500.

SEE ALSO

fafontremove(3W), fafontactivate(3W), fm_load(3W). 

DIAGNOSTICS

A value of -1 is returned if gfd is invalid, or a call to fainit was never executed on this gfd.  See errno(2) for further information. 

WARNING

When using either rectanglar fonts (pixelformat = 1) or HP-15 fonts (pixelformat = 2) with a low resolution display and retained rasters, the portion which gets obscured will lose every other pixel of information.  Also, 2-byte characters which are written to the obscured portion of the raster will appear twice the size they should be when the area is unobscured. 

Hewlett-Packard Company  —  May 11, 2021