Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XwcTextExtents()					      XwcTextExtents()

Name
  XwcTextExtents  – compute the extents of internationalized wide-charac‐
  ter text.

Synopsis
  int XwcTextExtents(font_set, string, num_wchars, overall_ink_return,
  overall_logical_return)
	XFontSet font_set;
	wchar_t *string;
	int num_wchars;
	XRectangle *overall_ink_return;
	XRectangle *overall_logical_return;

Arguments
  font_set  Specifies the font set.

  string    Specifies the character string.

  num_wchars
	    Specifies the number of characters in the string argument.

  overall_ink_return
	    Returns the overall ink dimensions.

  overall_logical_return
	    Returns the overall logical dimensions.

Returns
  The escapement in pixels.

Availability
  Release 5 and later.

Description
  XwcTextExtents()  sets  the	components   of	  the	specified   over‐
  all_ink_return  and  overall_logical_return  arguments  to  the overall
  bounding box of the string's image, and the  overall	logical	 bounding
  box  of the string's image plus inter-line and inter-character spacing.
  It returns the value returned	 by  XwcTextEscapement().   The	 returned
  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.	  Note	that  the
  overall_ink_return  for  a  non-descending  horizontally  drawn   Latin
  character    is    conventionally    entirely	  above	  the	baseline,
  that	is,  overall_ink_return.height	<=  -overall_ink_return.y.    The
  overall_ink_return  for a nonkerned character is entirely at and to the
  right of the origin, that is, overall_ink_return.x >= 0.   A	character
  consisting   of   a	single	 pixel	 at   the   origin   would   have
  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 which provides minimum spacing to other graphical features
  for the string.  Other graphical features, for example, a  border  sur‐
  rounding 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	 XCreate‐
  FontSet() so that the metrics represent the text as it will actually be
  drawn.  The behavior for an invalid codepoint is undefined.

Structures
     typedef struct {
	 short x, y;
	 unsigned short width, height;
     } XRectangle;

See Also
  XwcTextEscapement(), XwcTextPerCharExtents(), XmbTextExtents().

Xlib - Internationalized Text Output			      XwcTextExtents()

Vote for polarhome