XDrawImageString16(display, d, gc, x, y, string, length)
Display *display;
Drawable d;
GC gc;
int x, y;
XChar2b *string;
int length;
関数の動作としては、まず描画対象の長方形領域を GC で定義されている背景 色のピクセルで塗りつぶし、次に前景色でテキストを描く。 塗りつぶされる長方形の左上の点の座標は次のようになる。
[x, y - font-ascent]
幅は
overall-width
となり、高さは
font-ascent + font-descent
となる。 この overall-width, font-ascent, and font-descent は GC と文字列に対し て XQueryTextExtents が返す値である。 これらの関数は、GC で定義されている function と fill-style を無視する。 実際に使われる function は GXcopy であり、実際に使われる fill-style は FillSolid である。
2バイト行列形式のインデックスで定義され、 XDrawImageString で使われるフォントに対しては、各バイトは byte2 として扱われ、byte1 は 0 として扱われる。
いずれの関数も以下の GC コンポーネントを使用する: plane-mask, foreground, background, font, subwindow-mode, clip-x-origin, clip-y-origin, clip-mask。
XDrawImageString と XDrawImageString16 はエラー BadDrawable, BadGC, BadMatch を起こすことがある。