XDrawStrinB(3x) — HPUX 9.05

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

displaySpecifies a connection to an X server; returned from XOpenDisplay().

drawableSpecifies the drawable.

gcSpecifies the graphics context.

ySpecify the x and y coordinates of the baseline starting position for the character, relative to the origin of the specified drawable.

stringSpecifies the character string. Characters are two bytes wide.

lengthSpecifies 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 measured. 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, 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