PfLoadMetrics()

Load metric information for the given font

Synopsis:

#include <photon/Pf.h>

int PfLoadMetrics( const char *font );

Library:

ph

Description:

This function loads metric information for the given font from the font server into memory and links this font into a list of available local metrics. Use PfGenerateFontName() to build the font name.

Subsequent text extents of this base font, involving characters solely within this font, are performed locally by the task itself rather than by the font server. This may result in faster operation of extent-intensive tasks, such as HTML viewers, at a cost of about 1400 bytes of memory per font (for a standard font that defines characters 0x20-0xFF).

Returns:

0

Success.

-1

An error occurred; errno is set.

Classification:

Photon

See also:

PfGenerateFontName(), PfUnloadMetrics()

Fonts chapter of the Photon Programmer's Guide