Query: xdrawstrinb
OS: hpux
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
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 position for the character, relative to the origin of the specified
y drawable.
string Specifies the character string. Characters are two bytes wide.
length Specifies the number of characters in string.
Description
XDrawString16() 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 coordinate 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_ori-
gin, and clip_mask. This function also uses these graphics context mode-dependent components: foreground, background, tile, stipple,
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 Also
XDrawImageString(), XDrawImageString16(), XDrawString(), XDrawText(), XDrawText16(), XQueryTextExtents(), XQueryTextExtents16(), XTextEx-
tents(), XTextExtents16(), XTextWidth(), XTextWidth16().
Xlib - Text XDrawString16()