PfGlyph()

Obtain the metrics and/or bitmap for the specified character

Synopsis:

#include <photon/Pf.h>

int PfGlyph( const char *font,
             long symbol,
             FontRender *metrics, 
             unsigned char *bitmap, 
             int size,
             FontName fontused);

Description:

This routine is useful for obtaining arbitrary character glyphs, such as cursors. The PfGlyph() function obtains from the base font the metrics and/or bitmap for the character specified by symbol. When metrics is non-NULL, it must point to a FontRender structure that will be filled in with the character metrics (see PfRenderText()).

When bitmap is non-NULL, it must point to an area of size bytes that the character bitmap will be placed in. It may be rendered as a bitmap/image in conjunction with the metrics information. The actual font used to supply the character will be placed in the string pointed to by fontused if non-NULL.

Returns:

0

Success.

-1

An error occurred; the value of errno is set appropriately.

Classification:

Photon

See also:

PfRenderText()