hpux man page for xloadqueryfont

XLoadQueryFont()														  XLoadQueryFont()

Name
  XLoadQueryFont - load a font and fill information structure.

Synopsis
  XFontStruct *XLoadQueryFont(display, name)
	Display *display;
	char *name;

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

  name	    Specifies  the  name of the font.  This name is a NULL-terminated string.  As of Release 4, the * and ? wildcards are allowed and
	    may be supported by the server.  Uppercase or lowercase is not important.  If the font name is not in the Host Portable Character
	    Encoding, the result is implementation-dependent.

Returns
  The font description structure.

Description
  XLoadQueryFont()  performs an XLoadFont() and XQueryFont() in a single operation.  XLoadQueryFont() provides the easiest way to get charac-
  ter-size tables for placing a proportional font.  That is, XLoadQueryFont() both opens (loads) the specified font and returns a pointer  to
  the appropriate XFontStruct structure.  If the font does not exist, XLoadQueryFont() returns NULL.

  The  XFontStruct structure consists of the font-specific information and a pointer to an array of XCharStruct structures for each character
  in the font.

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

Errors
  BadAlloc  Server has insufficient memory to store font.

  BadName   name specifies an unavailable font.

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;

     typedef struct {
	 short lbearing;	     /* origin to left edge of character */
	 short rbearing;	     /* origin to right edge of character */
	 short width;		     /* advance to next char's origin */
	 short ascent;		     /* baseline to top edge of character */
	 short descent; 	     /* baseline to bottom edge of character */
	 unsigned short attributes;  /* per char flags (not predefined) */
     } XCharStruct;

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

Xlib - Fonts															  XLoadQueryFont()