名称

XDrawLine, XDrawLines, XDrawSegments − 線および多角形を描く

形式

XDrawLine(display, d, gc, x1, y1, x2, y2)
      Display ∗display;
      Drawable d;
      GC gc;
      int x1, y1, x2, y2; XDrawLines(display, d, gc, points, npoints, mode)
      Display ∗display;
      Drawable d;
      GC gc;
      XPoint ∗points;
      int npoints;
      int mode; XDrawSegments(display, d, gc, segments, nsegments)
      Display ∗display;
      Drawable d;
      GC gc;
      XSegment ∗segments;
      int nsegments;

引数

ddrawable を指定します。

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

gcGC を指定します。

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

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

nsegments配列のセグメント数を指定します。

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

segmentsセグメントの配列を指すポインタを指定します。

x1

y1

x2

y2つなげられる点 (x1, y1) および (x2, y2) を指定します。

解説

XDrawLine 関数は、指定された GC の要素を使用し、指定された一組の点 (x1, y1) と (x2, y2) の間に線を引きます。 一致する終点同志に対しては join 処理を行いません。 どのような線が与えられても、 XDrawLine は 2回以上ピクセルを描きません。 線が交差する場合、交差するピクセルは複数回描かれます。 XDrawLines 関数は、指定された GC の要素を使用し、 XPoint 構造体の配列中の各点の組 (point[i], point[i+1]) の間に npoints−1 本の 線を引きます。 線は配列に並べた順に引かれます。 線はすべて中間ポイントで正しく接続し、 最初と最後の点が一致する場合には最初と最後の線は正しく結ばれます。 どのような線が与えられても、 XDrawLines は 2回以上ピクセルを描いたりしません。 細い（線幅 0）線が交差する場合、交差するピクセルは、 複数回描かれます。 幅のあるラインが交差する場合、交差するピクセルは、 あたかもこの PolyLine プロトコルリクエスト全体がひとつのぬりつぶし図形であるかのように 一度だけ描画されます。 CoordModeOrigin は、すべての座標を原点に相対的に扱い、 CoordModePrevious は、2番目以降のすべての座標を前の点に対して相対的に扱います。 XDrawSegments 関数は、複数の線をつながずに引きます。 各セグメントについて、 XDrawSegments は、(x1, y1) と (x2, y2) の間に線を引きます。 線は、 XSegment 構造体の配列に並べられた順に引かれ、終点同志が一致しても join 処理は しません。 いかなる線が与えられても、 XDrawSegments は、2回以上ピクセルを描画しません。 線が交差する場合、交差するピクセルは、複数回描かれます。 3つの関数すべてが、以下の GC の要素を使用します : function、plane-mask、line-width、 line-style、cap-style、fill-style、subwindow-mode、 clip-x-origin、clip-y-origin および clip-mask。 XDrawLines 関数は、join-style GC 要素も使用します。 3つの関数すべては、以下の GC モード依存要素も使用します : foreground、background、tile、stipple、tile-stipple-x-origin、 tile-stipple-y-origin、dash-offset および dash-list。 .PN XDrawLine 、 .PN XDrawLines および .PN XDrawSegments が発生するのは、 BadDrawable、 BadGC および BadMatch エラーです。 また、 XDrawLines は BadValue エラーも生じます。

診断

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

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

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

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

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

関連事項

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

NEWS-OSRelease 3.3