名称

XSetClipOrigin, XSetClipMask, XSetClipRectangles − GC のための 簡易ルーチン

形式

XSetClipOrigin(display, gc, clip_x_origin, clip_y_origin)
      Display ∗display;
      GC gc;
      int clip_x_origin, clip_y_origin; XSetClipMask(display, gc, pixmap)
      Display ∗display;
      GC gc;
      Pixmap pixmap; XSetClipRectangles(display, gc, clip_x_origin, clip_y_origin, rectangles, n, ordering)
      Display ∗display;
      GC gc;
      int clip_x_origin, clip_y_origin;
      XRectangle rectangles[];
      int n;
      int ordering;

引数

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

clip_x_origin

clip_y_origin
クリップマスク原点の x と y 座標を指定します。

gcGC を指定します。

n矩形の数を指定します。

ordering矩形の順序関係を指定します。 Unsorted、 YSorted、 YXSorted、 または YXBanded を渡すことができます。

pixmappixmap または None を指定します。

rectanglesクリップマスクを定義する矩形の配列を指定します。

解説

XSetClipOrigin 関数は、指定された GC 中のクリップの原点を設定します。 クリップマスクの原点は、グラフィックスリクエストで指定されるどんな デスティネーションドロウアブルの原点に対しても相対的に解釈されます。 .PN XSetClipOrigin は、 BadAlloc および BadGC エラーを生じることがあります。 XSetClipMask 関数は、指定された GC 中のクリップマスクを、指定された pixmap へ 設定します。 クリップマスクが None に設定されている場合、 ピクセルが、常に描かれます ( クリップ原点と無関係に ) 。 .PN XSetClipMask は、 BadAlloc、 BadGC、 BadMatch、 および BadValue エラーを生じることがあります。 XSetClipRectangles 関数は、指定された GC 中のクリップマスクを指定された矩形リストへ 変更し、クリップ原点を設定します。 出力は、矩形内に含まれているとおりにクリップされます。 クリップ原点は、グラフィックスリクエストで指定されるどんな デスティネーションドロウアブルの原点に対しても相対的に解釈されます。 矩形の座標はクリップ原点に対して相対的に解釈されます。 矩形は、交差してはなりません。さもないと、グラフィックスは、 結果として定義されないことになってしまいます。 なお、矩形のリストは、空でも良く、効果的に、出力を無効にすることに 注意してください。 これは、 XCreateGC、 XChangeGC、 および XSetClipMask 中のクリップマスクとして None を渡すのと逆のことです。 クライアントにより知られている場合には、矩形の順序関係は、 ordering 引数で指定することができます。 これにより、サーバはより速い操作を行うことができます。 間違った順序付けが指定された場合は、 X サーバは、 BadMatch エラーを生じてもよいが、そのエラーを生成することは要求されません。 エラーが生成された場合は、グラフィックスは、結果として定義されません。 Unsorted は、矩形が、任意順序にあることを意味します。 YSorted は、矩形が、それらの Y 原点では、減少しないことを意味します。 YXSorted は、さらに、等しい Y 原点をもつすべての矩形はそれらの X 原点内で 減少しないことを要求することにより YSorted 順序を束縛します。 YXBanded は、さらに、考えられるすべての Y 走査線について、その走査線を含む すべての矩形は、同一の Y 原点および Y エクステントをもつことを 要求することにより、 YXSorted を束縛します。 .PN XSetClipRectangles は、 BadAlloc、 BadGC、 BadMatch、 および BadValue エラーを生じることがあります。

診断

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

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

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

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

関連事項

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

NEWS-OSRelease 3.3