Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xqueryfont(3) [hpux man page]

XQueryFont()															      XQueryFont()

Name
  XQueryFont - return information about a loaded font.

Synopsis
  XFontStruct *XQueryFont(display, font_ID)
	Display *display;
	XID font_ID;

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

  font_ID   Specifies either the font ID or the graphics context ID.  You can declare the data type for this argument as either Font or GCon-
	    text (both X IDs).	If GContext, the font in that GC will be queried.

Returns
  The font information structure.

Description
  XQueryFont() returns a pointer to an XFontStruct structure containing information describing the specified font.  This call  is  needed  if
  you  loaded  the font with XLoadFont(), but need the font information to determine the extent of text.  XLoadQueryFont() combines these two
  operations.  XQueryTextExtents() is an alternative to avoid getting the complete font information, if you need the extents of  only  a  few
  strings.

  If the font hasn't been loaded (or the font ID passed is invalid), XQueryFont() returns NULL.

  If font_ID is declared as data type GContext (also a resource ID), this function queries the font specified by the font component of the GC
  specified by this ID.  This is useful for getting information about the default font, whose ID is stored in the default  GC.	 However,  in
  this	case  the  GContext ID will be the ID stored in the fid field of the returned XFontStruct, and you can't use that ID in XSetFont() or
  XUnloadFont(), since it is not itself the ID of the font.

  Use XFreeFont() to free this data.

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

Errors
  BadFont

Structures
     typedef struct {
	 XExtData *ext_data;	     /* hook for extension to hang data */
	 Font fid;		     /* font ID for this font */
	 unsigned direction;	     /* hint about direction 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(),
  XListFontsWithInfo(), XLoadFont(), XLoadQueryFont(), XSetFont(), XSetFontPath(), XUnloadFont().

Xlib - Fonts															      XQueryFont()

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