XSetLineAttributes(3X11)

名前
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 に設定する線のスタイルと端点のスタイルを指定する。 のいずれかを指定する。

dash_list
    指定した GC に設定する点線のスタイルに対するダッシュ(点線の構成要素 である短い線)のリストを指定する。

dash_offset
    指定した GC に設定する点線のスタイルのパターンの相を指定する。

display
    X サーバへの接続を指定する。

gc  GC を指定する。

join_style
    指定した GC に設定する線の接続スタイルを指定する。 のいずれかを指定する。

line_style
    指定した GC に設定する線のスタイルを指定する。 のいずれかを指定する。

line_width
    指定した GC に設定する線の幅を指定する。

n   dash_list の要素数を指定する。

説明
関数 は指定した GC の線の描画のコンポーネントを設定する。

はエラー を起こすことがある。

関数 は指定した GC の点線のスタイルの dash-offset 属性と dash-list 属性をセッ トする。 指定した dash_list には最低1つの要素がなければならない。無い場合には エラー となる。 dash_list の最初の要素から交互の要素(2番目、4番目等)は偶数番目のダッシュ であり、残りが奇数番目のダッシュである。 全ての要素は 0 であってはならず、そうでない場合はエラー となる。 奇数番目の長さのリストを指定することは、自分自身を繋げがる同じリストを 指定して偶数番目の長さのリストを作ることと等価である。

dash-offset はパターンの位相を定義する。 これは単独のグラフィックスリクエストで、dash-list 中のいくつのピクセル でパターンを実際に始めるかを指定する。 点線は join-style と繋がるまで軌跡上を続く。しかし、線を接続する場合に は各シーケンス間で位相は dash-offset に再設定される。

ダッシュの長さの単位は、通常の座標系と同じである。 理想的にはダッシュの長さは線の勾配に沿って測るべきだが、実装に対して要 求されているのは水平な線と垂直な線の場合に理想的になっていることだけで あ る。 理想的にできない場合のために、線の長軸に沿って長さを測る方法を示してお く。 x 軸となす各が-45度から+45度、135度から225度である線に対しては、x 軸 が長軸であると定義される。 これ以外の場合には、長軸は y 軸である。

はエラー を起こすことがある。

返り値

要求されたリソースやサーバメモリの割り当てにサーバが失敗した。

引き数 GContext の値が、定義されている GContext を指していない。

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

関連項目
XCreateGC(3X11), XQueryBestSize(3X11), XSetArcMode(3X11), XSetClipOrigin(3X11), XSetFillStyle(3X11), XSetFont(3X11), XSetState(3X11), XSetTile(3X11)
Xlib - C Language X Interface