名称

XDrawRectangle, XDrawRectangles − 長方形を描画する

形式

XDrawRectangle(display, d, gc, x, y, width, height)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y;
      unsigned int width, height; XDrawRectangles(display, d, gc, rectangles, nrectangles)
      Display ∗display;
      Drawable d;
      GC gc;
      XRectangle rectangles[];
      int nrectangles;

引数

ddrawable を指定します。

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

gcGC を指定します。

nrectangles配列中の長方形の数を指定します。

rectangles長方形の配列を指すポインタを指定します。

width

height長方形の寸法を指定する幅と高さを指定します。

x

yx - y 座標を指定し、長方形の上部左側の角を指定します。

解説

XDrawRectangle および XDrawRectangles 関数は、各長方形について 5点の PolyLine プロトコルリクエストが指定されたのと同様に、 指定された長方形の輪郭を描画します:

[x,y] [x+width,y] [x+width,y+height] [x,y+height] [x,y] 指定された長方形について、これらの関数は 2回以上ピクセルを描きません。 XDrawRectangles は、配列内に並べられた順に長方形を描画します。 長方形が交差する場合、 交差するピクセルは複数回描かれます。 両方の関数とも、以下の GC の要素を使用します : function、plane-mask、line-width、line-style、join-style、 fill-style、subwindow-mode、clip-x-origin、 clip-y-origin および clip-mask。 また、同様に以下の GC モード依存要素を使用します: foreground、background、tile、stipple、tile-stipple-x-origin、 tile-stipple-y-origin、dash-offset および dash-list。 .PN XDrawRectangle と .PN XDrawRectangles が発生するのは、 BadDrawable、 BadGC および BadMatch エラーです。

診断

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

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

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

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

関連事項

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

NEWS-OSRelease 3.3