MirBSD manpage: XmbTextExtents(3), Xutf8TextExtents(3), XwcTextExtents(3)

XmbTextExtents(3X11)     XLIB FUNCTIONS      XmbTextExtents(3X11)


     XmbTextExtents, XwcTextExtents, Xutf8TextExtents - compute
     text extents


     int XmbTextExtents(XFontSet font_set, char *string, int
          num_bytes, XRectangle *overall_ink_return, XRectangle

     int XwcTextExtents(XFontSet font_set, wchar_t *string, int
          num_wchars, XRectangle *overall_ink_return, XRectangle

     int Xutf8TextExtents(XFontSet font_set, char *string, int
          num_bytes, XRectangle *overall_ink_return, XRectangle


     font_set  Specifies the font set.

     num_bytes Specifies the number of bytes in the string argu-

               Specifies the number of characters in the string

               Returns the overall ink dimensions.

               Returns the overall logical dimensions.

     string    Specifies the character string.


     The XmbTextExtents, XwcTextExtents and Xutf8TextExtents
     functions set the components of the specified
     overall_ink_return and overall_logical_return arguments to
     the overall bounding box of the string's image and a logical
     bounding box for spacing purposes, respectively. They return
     the value returned by XmbTextEscapement, XwcTextEscapement
     or Xutf8TextEscapement. These metrics are relative to the
     drawing origin of the string, using the fonts loaded for the
     specified font set.

     If the overall_ink_return argument is non-NULL, it is set to
     the bounding box of the string's character ink. The
     overall_ink_return for a nondescending, horizontally drawn
     Latin character is conventionally entirely above the base-
     line; that is, overall_ink_return.height <=
     -overall_ink_return.y. The overall_ink_return for a

XFree86                   Version 4.5.0                         1

XmbTextExtents(3X11)     XLIB FUNCTIONS      XmbTextExtents(3X11)

     nonkerned character is entirely at, and to the right of, the
     origin; that is, overall_ink_return.x >= 0. A character con-
     sisting of a single pixel at the origin would set
     overall_ink_return fields y = 0, x = 0, width = 1, and
     height = 1.

     If the overall_logical_return argument is non-NULL, it is
     set to the bounding box that provides minimum spacing to
     other graphical features for the string. Other graphical
     features, for example, a border surrounding the text, should
     not intersect this rectangle.

     When the XFontSet has missing charsets, metrics for each
     unavailable character are taken from the default string
     returned by XCreateFontSet so that the metrics represent the
     text as it will actually be drawn. The behavior for an
     invalid codepoint is undefined.

     The function Xutf8TextExtents is an XFree86 extension intro-
     duced in XFree86 4.0.2. Its presence is indicated by the
     macro X_HAVE_UTF8_STRING.


     XmbTextEscapement(3X11), XmbTextPerCharExtents(3X11) Xlib -
     C Language X Interface

XFree86                   Version 4.5.0                         2

Generated on 2021-12-07 11:07:08 by $MirOS: src/scripts/roff2htm,v 1.103 2021/01/23 20:24:35 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2021 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.