XExtentsOfFontSet()XExtentsOfFontSet()NameXExtentsOfFontSet – 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.
DescriptionXExtentsOfFontSet() returns an XFontSetExtents() structure for the
given font set.
The XFontSetExtents() structure is owned by Xlib and should not be mod‐
ified 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 Xmb‐
TextExtents and XwcTextExtents for detailed semantics.
The max_logical_extent member gives the maximum extent, over all draw‐
able characters, of the rectangles which specify minimum spacing to
other graphical features, relative to a constant origin. Other graphi‐
cal features drawn by the client, for example, a border surrounding the
text, should not intersect this rectangle. The max_logical_extent mem‐
ber 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 AlsoXCreateFontSet(), XFontsOfFontSet().
Xlib - Text Output XExtentsOfFontSet()
