PfLoadMetrics()

Load metric information for the given font

Synopsis:

#include <photon/Pf.h>

int PfLoadMetrics( const char *font );

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.

Subsequent text extents of this base font, involving characters solely within this font, will be 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; the value of errno is set appropriately.

Classification:

Photon