FONTREQUEST(3R)

NAME
fontrequest, fontrelease, fontavail - request/release use of a font

SYNOPSIS
#include <dmd.h>
#include <font.h>

Font *fontrequest (fname)

void fontrelease (fname)

Font *fontavail (fname)

char *fname;

DESCRIPTION
Fname points to a font name, a null terminated string of up to 14 characters.

The fontrequest function returns a pointer to a font of the given name in the font cache. This routine will return 0 if one of the following conditions is true:

-   there is no font of the given name in the cache,

-   there is no more memory to attach the request information to the font,

-   the calling process has already requested the named font.

While the font is requested, no process can remove it from the cache until it is released.

The fontrelease function tells the cache that the named font is no longer being used by the calling process. This is automatically done for all the fonts that a process has requested when that process exits or is deleted.

The fontavail function returns a pointer to the named font if it is in the font cache; 0, otherwise. This function is used only to check if a given font is in the cache, and it cannot substitute for fontrequest if the application intends to make use of the font.

SEE ALSO
fontname(3R), fontsave(3L), infont(3R/3L), structures(3R).