Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xloadqueryfont(3) [hpux man page]

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()

Check Out this Related Man Page

XTextWidth16()															    XTextWidth16()

Name
  XTextWidth16 - get the width in pixels of a 16-bit character string, locally.

Synopsis
  int XTextWidth16(font_struct, string, count)
	XFontStruct *font_struct;
	XChar2b *string;
	int count;

Arguments
  font_struct
	    Specifies the font description structure of the font in which you want to draw the string.

  string    Specifies a character string made up of XChar2b structures.

  count     Specifies the character count in string.

Returns
  The width in pixels.

Description
  XTextWidth16()  returns the width in pixels of the specified string using the specified font.  This is the sum of the XCharStruct.width for
  each character in the string.  This is also equivalent to the value of overall.width returned by XQueryTextExtents16() or XTextExtents16().

  The calculation is done assuming 16-bit font indexing.

  For more information on drawing text, 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
  XDrawImageString(), XDrawImageString16(), XDrawString(), XDrawString16(), XDrawText(),  XDrawText16(),  XQueryTextExtents(),	XQueryTextEx-
  tents16(), XTextExtents(), XTextExtents16(), XTextWidth().

Xlib - Text															    XTextWidth16()
Man Page