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);

Library:

ph

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, which the function fills in with the character metrics (see PfRenderText()).

The base font is identified by the font argument, which you should create by calling PfGenerateFontName().

When bitmap is non-NULL, it must point to an area of size bytes that the character bitmap can 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 is 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:

PfGenerateFontName(), PfGetOutline(), PfRenderText()

Fonts chapter of the Photon Programmer's Guide