名称

XCreateGC, XCopyGC, XChangeGC, XFreeGC, XGContextFromGC − グラフィックコンテキストを作成または解放する

形式

GC XCreateGC(display, d, valuemask, values)
      Display ∗display;
      Drawable d;
      unsigned long valuemask;
      XGCValues ∗values; XCopyGC(display, src, valuemask, dest)
      Display ∗display;
      GC src, dest;
      unsigned long valuemask; XChangeGC(display, gc, valuemask, values)
      Display ∗display;
      GC gc;
      unsigned long valuemask;
      XGCValues ∗values; XFreeGC(display, gc)
      Display ∗display;
      GC gc; GContext XGContextFromGC(gc)
      GC gc;

引数

ddrawable を指定します。

dest目的 GC を指定します。

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

gcGC を指定します。

src元の GC の構成要素を指定します。

valuemaskGC のどの構成要素を設定 、コピーまたは変更するかを指定します。 この引数は、ひとつ以上の有効な GC 構成要素マスクビット単位の内包的 論理和です。

valuesどの値でも valuemask で指定されたとおりに指定します。

解説

XCreateGC 関数は、グラフィックコンテキストを作成し、GC を返します。 GC は、指定された drawable と同じ root と depth をもつ 目的 drawable とともに使用できます。 他の drawable とともに使用すると、 BadMatch エラーが生じます。 .PN XCreateGC の返しうるエラーは、 BadAlloc、 BadDrawable、 BadFont、 BadMatch、 BadPixmap および BadValue です。 XCopyGC 関数は、元の GC から目的 GC へ指定された要素をコピーします。 元の、および目的の GC は、同じ root と depth をもたなければなりません。 さもなければ BadMatch エラーが生じます。 valuemask は、 XCreateGC と同様に、どの構成要素をコピーするかを指定します。 .PN XCopyGC の返しうるエラーは、 BadAlloc、 BadGC および BadMatch です。 XChangeGC 関数は、指定された GC の valuemask で指定された構成要素を変更します。 values 引数は、設定する値を含んでいます。 値と制限は、 XCreateGC と同じです。 clip-mask を変更すると、コンテキストに対する前の XSetClipRectangles リクエストが無効になります。 dash-offset または dash-list を変更すると、 コンテキストに対する前の XSetDashes リクエストが無効になります。 構成要素を検証し、変更する順序は、サーバに依存します。 エラーが生じた場合、構成要素のサブセットが変更されたかもしれません。 .PN XChangeGC の返しうるエラーは、 BadAlloc、 BadFont、 BadGC、 BadMatch、 BadPixmap および BadValue です。 XFreeGC 関数は、指定された GC および関連するすべての記憶領域を破壊します。 .PN XFreeGC の返しうるエラーは、 BadGC です。

診断

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

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

BadFont Font または GContext 引数の値が、定義された Font を指さない。

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

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

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

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

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

関連事項

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

NEWS-OSRelease 3.3