hpux man page for xextentsoffontset

XExtentsOfFontSet()													       XExtentsOfFontSet()

Name
  XExtentsOfFontSet - obtain the maximum extents structure for a font set.

Synopsis
  XFontSetExtents *XExtentsOfFontSet(font_set)
	    XFontSet font_set;

Arguments
  font_set  Specifies the font set.

Returns
  A structure containing the extents.

Availability
  Release 5 and later.

Description
  XExtentsOfFontSet() returns an XFontSetExtents() structure for the given font set.

  The  XFontSetExtents()  structure is owned by Xlib and should not be modified or freed by the client.  It will be freed by a call to XFree-
  FontSet() with the associated XFontSet.  Until freed, its contents will not be modified by Xlib.

Structures
  The XFontSetExtents structure contains:

     typedef struct {
	 XRectangle max_ink_extent;	 /*over all drawable characters*/
	 XRectangle max_logical_extent;  /*over all drawable characters*/
     } XFontSetExtents;

  The XRectangles used to return font set metrics are the usual Xlib screen-oriented XRectangles, with x, y giving the upper-left corner, and
  width and height always positive.

  The  max_ink_extent  member gives the maximum extent, over all drawable characters, of the rectangles which bound the character glyph image
  drawn in the foreground color, relative to a constant origin.  See XmbTextExtents and XwcTextExtents for detailed semantics.

  The max_logical_extent member gives the maximum extent, over all drawable characters, of the rectangles which specify  minimum  spacing  to
  other  graphical  features, relative to a constant origin.  Other graphical features drawn by the client, for example, a border surrounding
  the text, should not intersect this rectangle.  The max_logical_extent member should be used to compute minimum interline spacing  and  the
  minimum area which must be allowed in a text field to draw a given number of arbitrary characters.

  Due to context-dependent rendering, appending a given character to a string may increase the string's extent by an amount which exceeds the
  font's max extent:

     max possible added extent = (max_extent * <total # chars>) - prev_string_extent

See Also
  XCreateFontSet(), XFontsOfFontSet().

Xlib - Text Output													       XExtentsOfFontSet()