XDrawImageB(3x) — HPUX 9.05

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

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 image text character, relative to the origin of the specified drawable.

stringSpecifies the character string.

lengthSpecifies the number of characters in the string argument.

Description

XDrawImageString16() 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 background pixel defined in gc, and then paints the text with the foreground 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