Name

PEXListFonts - List PEX Fonts

Synopsis

char ∗∗PEXListFonts(Display ∗display, char ∗pattern, unsigned int max_names, unsigned long ∗count_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. 

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 XListFonts except only information about fonts that can support the full range of PEX text attributes is returned (i.e. only those fonts that are "PEX usable"). This list may or may not contain some of the same fonts returned by the X11 XListFonts function.  This function returns a list of entries, each of which contains the name of 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.

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

Errors

None

See Also

PEXListFontsWithInfo, PEXFreeFontNames