fafontload(3w)

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.

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 rectangular fonts (pixelformat = 1) or HP-15 fonts (pixelformat = 2) with a low resolution display and retained rasters, the portion that gets obscured will lose every other pixel of information. Also, 2-byte characters that are written to the obscured portion of the raster will appear twice the size they should be when the area is unobscured.

Museum

Related Articles