PfQueryFonts()

Construct a list of fonts

Synopsis:

#include <photon/Pf.h>

int PfQueryFonts( long symbol, 
                  unsigned flags, 
                  FontDetails list[], 
                  int n );

Description:

This function constructs a list of all fonts that may be used to render the character specified by the symbol parameter. For example, use 'A' to get a list of normal/Latin fonts, or 0x3A9 (omega) to get a list of Greek fonts. (See PkKeyDef.h or ISO/EIC 10646-1 for a list of symbols.)

The list of fonts is further filtered by the flags parameter, which may contain any combination of the following:

Up to n matching font family entries are placed in the user-provided list. Each entry contains the following fields:

char desc[32]

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

char stem[16]

Base stem of the font family (e.g. helv).

short losize

Lowest point size available for this font. If losize and hisize are both 0, the font is scalable.

short hisize

Highest point size available for this font. If hisize and losize are both 0, the font is scalable.

unsigned short flags

Various stylistic/attribute flags for this font family:

• 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.

Returns:

The number of matching fonts found, or -1 on error. Also, the list array is constructed.

Classification:

Photon

See also:

PtFontSel (in the Photon Widget Reference)