XDrawImageString16()XDrawImageString16()Name
XDrawImageString16 – draw 16-bit image text characters.
Synopsis
XDrawImageString16(display, drawable, gc, x, y, string, length)
Display *display;
Drawable drawable;
GC gc;
int x, y;
XChar2b *string;
int length;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
drawable Specifies the drawable.
gc Specifies the graphics context.
x Specify the x and y coordinates of the baseline starting
y position for the image text character, relative to the origin
of the specified drawable.
string Specifies the character string.
length Specifies the number of characters in the string argument.
DescriptionXDrawImageString16() draws a string, but unlike XDrawString16() it
draws both the foreground and the background of the characters. It
draws the characters in the foreground and fills the bounding box with
the background.
XDrawImageString16() uses these graphics context components:
plane_mask, foreground, background, font, subwindow_mode,
clip_x_origin, clip_y_ origin, and clip_mask. The function and
fill_style defined in gc are ignored; the effective function is GXcopy
and the effective fill_style is FillSolid.
XDrawImageString16() first fills a destination rectangle with the back‐
ground pixel defined in gc, and then paints the text with the fore‐
ground pixel. The upper-left corner of the filled rectangle is at [x,
y - font_ascent], the width is overall->width and the height is ascent
+ descent, where overall->width, ascent, and descent are as would be
returned by XQueryTextExtents16() using gc and string.
For more information, see Volume One, Chapter 6, Drawing Graphics and
Text, and Chapter 5, The Graphics Context.
Structures
typedef struct {
unsigned char byte1;
unsigned char byte2;
} XChar2b;
Errors
BadDrawable
BadGC
BadMatch
See AlsoXDrawImageString(), XDrawString(), XDrawString16(), XDrawText(), XDraw‐
Text16(), XQueryTextExtents(), XQueryTextExtents16(), XTextExtents(),
XTextExtents16(), XTextWidth(), XTextWidth16().
Xlib - Text XDrawImageString16()