hpux man page for xlistfontswithinfo

XListFontsWithInfo()													      XListFontsWithInfo()

Name
  XListFontsWithInfo - obtain the names and information about available fonts.

Synopsis
  char **XListFontsWithInfo(display, pattern, maxnames,
	    count_return, info_return)
	Display *display;
	char *pattern;		/* NULL-terminated */
	int maxnames;
	int *count_return;
	XFontStruct **info_return;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  pattern   Specifies  the  string associated with the font names you want returned.  You can specify any string, including asterisks (*) and
	    question marks (?).  The asterisk indicates a wildcard on any number of characters and the question mark indicates a wildcard  on
	    a single character.  Uppercase or lowercase is not important.  If the pattern string is not in the Host Portable Character Encod-
	    ing the result is implementation-dependent.

  maxnames  Specifies the maximum number of names that are to be in the returned list.

  count_return
	    Returns the actual number of matched font names.

  info_return
	    Returns a pointer to a list of font information structures.  XListFontsWithInfo() provides enough space for maxnames pointers.

Returns
  The list of font names.

Description
  XListFontsWithInfo() returns a list of font names that match the specified pattern and a also returns limited information about  each  font
  that	matches.   The list of names is limited to the size specified by the maxnames argument.  If the data returned by the server is in the
  Latin Portable Character Encoding, then the returned strings are in the Host Portable Character Encoding.  Otherwise, the result is  imple-
  mentation-dependent.

  XListFontsWithInfo() returns NULL if no matches were found.

  To  free  the  allocated  name  array, the client should call XFreeFontNames().  To free the font information array, the client should call
  XFreeFontInfo().

  The information returned for each font is identical to what XLoadQueryFont() would return, except that the per-character metrics (lbearing,
  rbearing, width, ascent, descent for single characters) are not returned.

  The font search path (the order in which font names in various directories are compared to pattern) is set by XSetFontPath().

  For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text.

Structures
     typedef struct {
	 XExtData *ext_data;	     /* hook for extension to hang data */
	 Font fid;		     /* Font ID for this font */
	 unsigned direction;	     /* hint about direction the font is painted */
	 unsigned min_char_or_byte2; /* first character */
	 unsigned max_char_or_byte2; /* last character */
	 unsigned min_byte1;	     /* first row that exists */
	 unsigned max_byte1;	     /* last row that exists */
	 Bool all_chars_exist;	     /* flag if all characters have non-zero size */
	 unsigned default_char;      /* char to print for undefined character */
	 int n_properties;	     /* how many properties there are */
	 XFontProp *properties;      /* pointer to array of additional properties */
	 XCharStruct min_bounds;     /* minimum bounds over all existing char */
	 XCharStruct max_bounds;     /* maximum bounds over all existing char */
	 XCharStruct *per_char;      /* first_char to last_char information */
	 int ascent;		     /* logical extent above baseline for spacing */
	 int descent;		     /* logical descent below baseline for spacing */
     } XFontStruct;

See Also
  XCreateFontCursor(),	XFreeFont(),  XFreeFontInfo(),	XFreeFontNames(),  XFreeFontPath(), XGetFontPath(), XGetFontProperty(), XListFonts(),
  XLoadFont(), XLoadQueryFont(), XQueryFont(), XSetFont(), XSetFontPath(), XUnloadFont().

Xlib - Fonts														      XListFontsWithInfo()