PfQueryFont()

Get information about a font

Synopsis:

#include <photon/Pf.h>

int PfQueryFont( const char *font, 
                 FontQueryInfo *info);

Description:

This function gets information about the font specified by font after first mapping font to a valid font name (if appropriate). The FontQueryInfo structure pointed to by info is filled in. It contains at least:

FontName font

Internal name of the font (e.g. helv12b).

FontDescription desc

Textual name of the font family (e.g. Helvetica).

short size

Point size of the font.

unsigned short style

Style and attributes of this font, made up of the following bits:

• PHFONT_INFO_PROP - proportional-width font.
• PHFONT_INFO_FIXED - fixed-width font.
• PHFONT_INFO_PLAIN - plain/regular style.
• PHFONT_INFO_BOLD - bold style.
• PHFONT_INFO_ITALIC - italic style.
• PHFONT_INFO_BLDITC - bold italic style.

short ascender

Ascender value of the font (in pixels).

short descender

Descender value of the font (in pixels).

short width

Width of widest character in this font.

long lochar

Lowest character value defined in this font.

long hichar

Highest character value defined in this font.

Returns:

0

Successful completion.

-1

An error occurred (errno is set).

Classification:

Photon