XDrawString16()XDrawString16()Name
XDrawString16 – draw two-byte text strings.
Synopsis
XDrawString16(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 character, relative to the origin of the
specified drawable.
string Specifies the character string. Characters are two bytes
wide.
length Specifies the number of characters in string.
DescriptionXDrawString16() draws a string in the foreground pixel value without
drawing the surrounding pixels.
The y coordinate defines the baseline row of pixels while the x coordi‐
nate is the point from which lbearing, rbearing, and width are mea‐
sured. For more information on text placement, see Volume One, Chapter
6, Drawing Graphics and Text.
XDrawString16() uses these graphics context components: function,
plane_mask, fill_style, font, subwindow_mode, clip_x_origin,
clip_y_origin, and clip_mask. This function also uses these graphics
context mode-dependent components: foreground, background, tile, stip‐
ple, ts_x_origin, and ts_y_origin. Each character image, as defined by
the font in gc, is treated as an additional mask for a fill operation
on the drawable. For fonts defined with 2-byte matrix indexing and
used with XDrawString16(), each byte is used as a byte2 with a byte1 of
zero.
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 BadFont
BadGC
BadMatch
See AlsoXDrawImageString(), XDrawImageString16(), XDrawString(), XDrawText(),
XDrawText16(), XQueryTextExtents(), XQueryTextExtents16(), XTextEx‐
tents(), XTextExtents16(), XTextWidth(), XTextWidth16().
Xlib - Text XDrawString16()