[Previous] [Contents] [Index] [Next]

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

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PfRenderText()


[Previous] [Contents] [Index] [Next]