名称

XCopyArea, XCopyPlane − 領域をコピーする

形式

XCopyArea(display, src, dest, gc, src_x, src_y, width, height,  dest_x, dest_y)
      Display ∗display;
      Drawable src, dest;
      GC gc;
      int src_x, src_y;
      unsigned int width, height;
      int dest_x, dest_y; XCopyPlane(display, src, dest, gc, src_x, src_y, width, height, dest_x, dest_y, plane)
      Display ∗display;
      Drawable src, dest;
      GC gc;
      int src_x, src_y;
      unsigned int width, height;
      int dest_x, dest_y;
      unsigned long plane;

引数

dest_x

dest_yデスティネーションの長方形の原点に相対する x および y 座標を指定し、 その上部左側のコーナーを指定します。

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

gcGC を指定します。

planeビットプレーンを指定します。1 ビットを正しく 1 に設定します。

src

dest結合するソース、およびデスティネーションの長方形を指定します。

src_x

src_yソース長方形の原点に相対する x および y 座標を指定し、 その上部左側コーナーを指定します。

width

heightソース、およびデスティネーションの長方形の寸法である幅と高さを 指定します。

解説

XCopyArea 関数は、指定された src の長方形を指定された dest の長方形と結合します。 drawables は同じルート、および深さをもたなければなりません。 さもなければ、 BadMatch エラーが生じます。 ソース長方形のリージョンが隠され、 バッキングストアに保持されていない場合、 またはソース drawable の境界外のリージョンが指定された場合、 これらのリージョンはコピーされません。 実際には、ビジブルであるか、またはバッキングストアに保持されている、 すべての対応するデスティネーションリージョンで、以下のことが生じます。 バックグラウンドが None 以外のウィンドウをデスティネーションとする場合、 対応するデスティネーションリージョンは、 そのバックグラウンドでタイルされます ( GXcopy 関数、およびすべて 1 のプレーンマスク (plane-mask) で)。 タイリングと無関係に、またはデスティネーションがウィンドウであるか、 またはピクスマップであるかを問わず、graphics-exposures が True であれば、対応するすべてのデスティネーションリージョンについて、 GraphicsExpose イベントが発生します。 graphics-exposures が True で、 GraphicsExpose イベントが発生しなければ、 NoExpose が発生します。 新しい GC では、graphics-exposures のデフォルトは True であることに注意してください。 この関数は、以下の GC 構成要素を使用します。すなわち、function、 plane-mask、subwindow-mode、graphics-exposures、clip-x-origin、 clip-y-origin、clip-mask を使用します。 XCopyArea は、 BadDrawable、 BadGC および BadMatch エラーを生じることがあります。 XCopyPlane 関数は、指定された GC と組み合わせ、指定されたソース長方形の 1 ビット プレーンを使用し、指定されたデスティネーション長方形を変更します。 drawables が同じルートをもたなければならないが、同じ深さをもつ必要は ありません。 drawables が同じルートをもたない場合、 BadMatch エラーが生じます。 plane の 1 つのビットが 1 に設定されず、plane の値が %2 sup n% 以下 でなければならない場合 (ここでの n は scr の深さ)、 BadValue エラーが生じます。 実質的には、 XCopyPlane 深さがデスティネーション長方形と同じで、サイズがソースリージョンで 指定されたピクスマップを形成します。これは GC のフォアグラウンド／バ ックグラウンドピクセルを使用し ( src のビットプレーンが 1 に設定され たビットを含むフォアグラウンド、src のビットプレーンが 0 に設定され たビットを含むバックグラウンド)、 CopyArea プロトコルリクエストと同等の機能が、すべての同じエクスポージャセマン ティックスで実行されます。これは、デスティネーションの長方形の領域を フィルするため FillOpaqueStippled の fill-style を使用し、stipple としてソースビットプレーンの指定された リージョンを使用することとみなすこともでます。 この関数は、以下の GC 構成要素を使用します。すなわち、function、 plane-mask、foreground、background、subwindow-mode、 graphics-exposures、clip-x-origin、clip-y-origin、clip-mask を使用します。 XCopyPlane は、 BadDrawable、 BadGC、 BadMatch および BadValue エラーを生じることがあります。

診断

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

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

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

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

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

関連事項

XClearArea(3X11)
Xlib − C Language X Interface
 

NEWS-OSRelease 4.2.1R