名称

XDrawPoint, XDrawPoints, XPoint − 点の描画と構造体

形式

XDrawPoint(display, d, gc, x, y)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y; XDrawPoints(display, d, gc, points, npoints, mode)
      Display ∗display;
      Drawable d;
      GC gc;
      XPoint ∗points;
      int npoints;
      int mode;

引数

ddrawable を指定します。

displayX サーバ へのコネクションを指定します。

gcGC を指定します。

mode座標モードを指定します。 CoordModeOrigin または CoordModePrevious を渡すことができます。

npoints配列の中の点の数を指定します。

points点の配列を指すポインタを指定します。

x

y点を描画したい x − y 座標を指定します。

解説

XDrawPoint 関数は、GC の foreground ピクセルおよび function 要素を使用し、 指定された drawable に 1個の点を描画します。 そして XDrawPoints は、この方法で複数の点を描画します。 CoordModeOrigin は、すべての座標を原点に相対的に扱い、 CoordModePrevious は 2番目以降のすべての座標を前の点に相対的に扱います。 XDrawPoints は、配列に並べられた順に点を描画します。 両方の関数は、以下の GC の要素を使用します : function、plane-mask、 foreground、subwindow-mode、clip-x-origin、clip-y-origin および clip-mask。 XDrawPoint が発生するのは、 BadDrawable、 BadGC および BadMatch エラーです。 XDrawPoints は、 BadDrawable、 BadGC、 BadMatch および BadValue エラーを発生します。

構造体

XPoint

typedef struct {
      short x, y;
} XPoint;

すべての x, y メンバは、signed 型整数です。 横幅と縦の長さのメンバは、16 ビットの unsigned 型整数です。 プロトコルはこれらの値に対して、16 ビットのフィールドしか持ちません。 ですから、16ビットの範囲を越えて座標やサイズを指定しないよう注意が必要です。

診断

BadDrawable
Drawable 引数の値が、定義された Window または Pixmap を指さない。

BadGC GContext 引数の値が、定義された GContext を指さない。

BadMatch InputOnly ウィンドウが、Drawable として使用された。

BadMatch ある引数またはひと組の引数の型と範囲は正しいが、 リクエストによって要求されたその他のなにかが一致しない。

BadValue ある数値が、許容範囲を超えた。引数の値の範囲が明示されない限り、 引数の型によって決まる最大の範囲まで指定可能です。 選択形式の引数も、このエラーを生じることがあります。

関連事項

XDrawArc(3X11), XDrawLine(3X11), XDrawRectangle(3X11)
Xlib − C Language X Interface

NEWS-OS Release 4.1C