名称

XSetLineAttributes, XSetDashes - GC のための簡易ルーチン

形式

XSetLineAttributes(display, gc, line_width, line_style, cap_style, join_style)
      Display ∗display;
      GC gc;
      unsigned int line_width;
      int line_style;
      int cap_style;
      int join_style; XSetDashes(display, gc, dash_offset, dash_list, n)
        Display ∗display;
        GC gc;
        int dash_offset;
        char dash_list[];
        int n;

引数

cap_style指定された GC に、設定したいラインスタイル、およびキャップスタイルを 指定します。 CapNotLast、 CapButt、 CapRound または、 CapProjecting を指定することができます。

dash_list指定された GC に、設定したいダッシュされたラインスタイルのダッシュリ ストを指定します。

dash_offset指定された GC に、設定したいダッシュされたラインスタイルのパターンの フェーズを指定します。

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

gcGC を指定します。

join_style指定された GC に、設定したいラインの結合スタイルを指定します。 JoinMiter、 JoinRound または、 JoinBeval を指定することができます。

line_style指定された GC に、設定したいラインスタイルを指定します。 LineSolid、 LineOnOffDash または、
 
LineDoubleDash を指定することができます。

line_width指定された GC に、設定したいライン幅を指定します。

ndash_list 中の要素数を指定します。

解説

XSetLineAttributes 関数は、指定された GC 内にラインを引くための、構成要素を設定します。 XSetLineAttributes は、 BadAlloc、 BadGC および、 BadValue エラーを生じることがあります。 XSetDashes 関数は、指定された GC 内に、ダッシュされたラインスタイルのダッシュオ フセット、およびダッシュリスト属性を設定します。 指定された dash_list 内には、少なくともひとつの要素がなければなりませ ん。 さもないと、結果として BadValue エラーが生じます。 dash_list の最初、および代替の要素（ 2 番目、 4 番目等）は、偶数番目 のダッシュ、そして他の要素は奇数番目のダッシュです。 各要素は、ピクセル中のダッシュ長を指定します。 すべての要素は、 0 でない値でなければなりません。 さもないと、 BadValue エラーが生じます。 奇数長のリストを指定することは、偶数長のリストを作るために、それ自身 を連結されたのと同じリストを指定することと同じです。 dash-offset は、パターンのフェーズを定義し、パターンが 1 回のグラフィ ックスリクエストで、実際に始めなければならない dash-list へのピクセル 数を指定します。 ダッシングは、結合スタイルで組み合わされたパス要素を通して続きますが、 結合されたラインのそれぞれのシーケンスにおいて、ダッシュオフセットにリセ ットされます。 ダッシュの測定単位は、通常の座標システムのものと同じです。 理想的には、ダッシュ長は、ラインの傾斜に沿って測定されるが、インプリ メンテーションでは、この理想が、水平および垂直ラインについてだけ適合 するように要求されます。 この理想論に失敗したら、長さをラインの主要軸に沿って測定することをお 勧めします。 主要軸は、 x 軸から -45 度 および　+45 度の間、または 315 度 および 225 度の間の角度で引かれるラインに対しては、 x 軸として 定義されます。 他のすべてのラインについては、主要軸は y 軸です。 XSetDashes は、 BadAlloc、 BadGC および、 BadValue エラーを生じることがあります。

診断

BadAlloc サーバが要求されたリソース、またはサーバメモリの割当てに失敗した。

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

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

関連事項

XCreateGC(3X11), XQueryBestSize(3X11), XSetArcMode(3X11), XSetClipOrigin(3X11), XSetFillStyle(3X11), XSetFont(3X11), XSetState(3X11), XSetTile(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.1C