PEXListFontsWithInfo(3) — Subroutines

Name

PEXListFontsWithInfo - List PEX Fonts With Information

Synopsis

char ∗∗PEXListFontsWithInfo(Display ∗display, char ∗pattern, unsigned int max_names, unsigned long ∗count_return, PEXFontInfo ∗∗info_return)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call.

patternA null-terminated string pattern.

max_namesThe maximum number of names to be returned.

count_returnReturns the actual number of font names.

font_infoReturns an array of font info structures (one for each name).

Returns

An array of font names (null-terminated strings); a null pointer if unsuccessful or if no PEX fonts supported.

Description

This function is like X11 XListFontsWithInfo except that only information about fonts that can support the full range of PEX text attributes is returned (i.e. those fonts that are "PEX usable"). This list may or may not contain some of the same fonts returned the X11 XListFontsWithInfo function. This function returns a list of entries, each of which contains information about a font matching the pattern. The pattern is a string that uses the ISO Latin-1 encoding and case is not significant in matching names. The ’?’ character (octal value 077) matches any single character, and the character ’∗’ (octal value 052) matches any number of characters. The returned names are null-terminated, in lower case and are also ISO Latin-1 encoded strings.

The information returned for each font is identical to what PEXQueryFont would return.

PEXlib allocates memory for the returned list of font names and font info. PEXFreeFontNames should be called to deallocate the memory for the font names. PEXFreeFontInfo should be called to deallocate the memory for the font information.

Data Structures

typedef struct {
    unsigned long       first_glyph;
    unsigned long       last_glyph;
    unsigned long       default_glyph;
    Bool                all_exist;
    Bool                stroke;
    unsigned short      count;
    PEXFontProp         ∗props;
} PEXFontInfo;
typedef struct {
    Atom                name;
    unsigned long       value;
} PEXFontProp;

Errors

None

Museum