MirBSD manpage: XDrawImageString(3), XDrawImageString16(3)

XDrawImageString(3X11)   XLIB FUNCTIONS    XDrawImageString(3X11)


     XDrawImageString, XDrawImageString16 - draw image text


     int XDrawImageString(Display *display, Drawable d, GC gc,
          int x, int y, char *string, int length);

     int XDrawImageString16(Display *display, Drawable d, GC gc,
          int x, int y, XChar2b *string, int length);


     d         Specifies the drawable.

     display   Specifies the connection to the X server.

     gc        Specifies the GC.

     length    Specifies the number of characters in the string

     string    Specifies the character string. and define the
               origin of the first character

     y         Specify the x and y coordinates, which are rela-
               tive to the origin of the specified drawable.


     The XDrawImageString16 function is similar to XDrawImage-
     String except that it uses 2-byte or 16-bit characters. Both
     functions also use both the foreground and background pixels
     of the GC in the destination.

     The effect is first to fill a destination rectangle with the
     background pixel defined in the GC and then to paint the
     text with the foreground pixel. The upper-left corner of the
     filled rectangle is at:

     [x, y - font-ascent]

     The width is:


     The height is:

     font-ascent + font-descent

     The overall-width, font-ascent, and font-descent are as
     would be returned by XQueryTextExtents using gc and string.
     The function and fill-style defined in the GC are ignored
     for these functions. The effective function is GXcopy, and

XFree86                   Version 4.5.0                         1

XDrawImageString(3X11)   XLIB FUNCTIONS    XDrawImageString(3X11)

     the effective fill-style is FillSolid.

     For fonts defined with 2-byte matrix indexing and used with
     XDrawImageString, each byte is used as a byte2 with a byte1
     of zero.

     Both functions use these GC components: plane-mask, fore-
     ground, background, font, subwindow-mode, clip-x-origin,
     clip-y-origin, and clip-mask.

     XDrawImageString and XDrawImageString16 can generate Bad-
     Drawable, BadGC, and BadMatch errors.


               A value for a Drawable argument does not name a
               defined Window or Pixmap.

     BadGC     A value for a GContext argument does not name a
               defined GContext.

     BadMatch  An InputOnly window is used as a Drawable.

     BadMatch  Some argument or pair of arguments has the correct
               type and range but fails to match in some other
               way required by the request.


     XDrawString(3X11), XDrawText(3X11), XLoadFont(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.