名称

XPutImage, XGetImage, XGetSubImage − イメージを転送する

形式

XPutImage(display, d, gc, image, src_x, src_y, dest_x, dest_y, width, height)
        Display ∗display;
        Drawable d;
        GC gc;
        XImage ∗image;
        int src_x, src_y;
        int dest_x, dest_y;
        unsigned int width, height; XImage ∗XGetImage(display, d, x, y, width, height, plane_mask, format)
        Display ∗display;
        Drawable d;
        int x, y;
        unsigned int width, height;
        unsigned long plane_mask;
        int format; XImage ∗XGetSubImage(display, d, x, y, width, height, plane_mask, format, dest_image, dest_x,
                     dest_y)
      Display ∗display;
      Drawable d;
      int x, y;
      unsigned int width, height;
      unsigned long plane_mask;
      int format;
      XImage ∗dest_image;
      int dest_x, dest_y;

引数

ddrawable を指定します。

dest_image目的のイメージを指定します。 の原点に相対し、サブイメージの座標であるか、 または、目的矩形の原点、上部左側コーナー、に相対し、 目的イメージ中にサブイメージが置かれる場所を 決定します

dest_x

dest_y
 x と y 座標を指定します。それは、drawable。

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

formatイメージのフォーマットを指定します。 XYBitmap、 XYPixmap または ZPixmap を渡すことができます。

gcGC を指定します。

image矩形と組み合わせたいイメージを指定します。

plane_maskプレーンマスクを指定します。

src_xXImage データ構造体で定義されるイメージの左端からの X 方向のオフセットを指定します。

src_yXImage データ構造体が定義したイメージの上端からの Y 方向のオフセットを指定します。

width

heightサブイメージの幅と高さを指定します。 それは、矩形の寸法を指定します。 矩形の上部左側のコーナーを定義します

x

yx と y 座標を指定します。それは、drawable の原点に相対し、。

解説

XPutImage 関数は、 メモリ中のイメージを drawable と指定された矩形と組み合わせます。 XYBitmap フォーマットを使用した場合は、イメージの深さは 1 でなければなりません。 さもないと、 BadMatch エラーが結果として生じます。 GC 中のフォアグラウンドピクセルは、イメージ中の 1 を表わすビットで定義し、 バックグラウンドピクセルは、0 を表わすビットで定義されています。 XYPixmap と ZPixmap について、イメージの深さは、drawable の深さに一致しなければなりません。 さもないと BadMatch エラーが結果として生じます。 src_x、src_y、width および height 引数により定義されたイメージ部分は、drawable の中の指定された部分に描かれます。 XPutImage 関数は、GC 構成要素である function、plane-mask、subwindow-mode、clip-x-origin、 clip-y-origin および clip-mask を使用します。 また、これらの GC モード依存の構成要素である foreground と background も使用します。 XPutImage は、 BadDrawable、 BadGC、 BadMatch および BadValue エラーを生じることがあります。 XGetImage 関数は、 XImage 構造体を指すポインタを返します。 この構造体は、指定したフォーマットで、 drawable な指定された矩形の内容を提供します。 format 引数が XYPixmap である場合は、イメージは、 plane_mask 引数に渡したビットプレーンだけを含みます。 plane_mask 引数が、ディスプレイのプレーンのサブセットだけを要求する 場合は、返されたイメージの深さは、要求されたプレーンの数です。 format 引数が ZPixmap の場合は、 XGetImage は、plane_mask 引数で指定されていない すべてのプレーンのビットを 0 として返します。 XGetImage は、plane_mask 中の値のレンジのチェックは行わず、 無関係なビットは無視します。 XGetImage は、イメージの深さを、 XImage 構造体の depth メンバーに返します。 イメージの深さは、 XYPixmap フォーマットのプレーンのサブセットを得たとき、深さが、plane_mask 中の 1 に設定されたビット数により与えられるときを除いて、drawable が 作成されたときのように指定されます。 drawable が pixmap である場合、 与えられた矩形は、pixmap 内に完全に含まれなければなりません。 さもないと、 BadMatch エラーが結果として生じます。 drawable がウィンドウである場合は、 ウィンドウは、表示されていなければならず、 下位またはオーバーラップされたウィンドウが何もない場合は、 ウィンドウの指定された矩形は、完全にスクリーン上に見ることができ、 ウィンドウの外側のエッジ内に完全に含まれる状態でなければなりません。 さもないと、 BadMatch エラーが結果として生じます。 なお、ウィンドウのボーダは、含むことができ、このリクエストと いっしょに読込むことができることに注意して下さい。 ウィンドウがバッキング - ストアをもっている場合は、 バッキングストアの内容は、上位のウィンドウにより隠されたウィンドウ のリージョンで返されます。 ウィンドウが、バッキング - ストアを持っていない場合は、 そのような、隠されたリージョンについて返される内容は定義されていません。 指定されたウィンドウの深さと異なる深さの下位のビューアブルな リージョンについて返される内容についても定義されていません。 ポインタカーソルイメージは、返される内容には含まれていません。 何か問題がある場合、 XGetImage は NULL を返します。 XGetImage は、 BadDrawable、 BadMatch および BadValue エラーを生じることがあります。 XGetSubImage 関数は、 XGetImage と同じ方法で指定されたサブイメージを用いて dest_image を変更します。 format 引数が XYPixmap の場合は、イメージは、plane_mask 引数に渡したビットプレーンだけを含みます。 format 引数が ZPixmap の場合は、 XGetSubImage は、plane_mask 引数で指定されていないすべての プレーン中のビットを 0 として返します。 XGetSubImage 関数は、plane_mask 中の値のレンジのチェックは行わず、 無関係なビットは無視します。 便宜上、 XGetSubImage は、dest_image が指定する同一の XImage 構造体を指すポインタを返します。 目的の XImage 構造体の深さは、drawable の深さと同じでなければなりません。 指定されたサブイメージが、目的のイメージ上の指定された位置で一致しない 場合は、右側および下部のエッジがクリップされます。 drawable が pixmap の場合は、 与えられた矩形は、pixmap 内に完全に含まれなければなりません。 さもないと、 BadMatch エラーが結果として生じます。 drawable がウィンドウの場合は、 ウィンドウは表示されていなければならず、 下位またはオーバーラップされたウィンドウがない場合は、 ウィンドウの指定された矩形は、完全にスクリーン上に見ることができ、 ウィンドウの外側のエッジ内に完全に含まれている状態でなければなません。 さもないと、 BadMatch エラーが結果として生じます。 ウィンドウがバッキングストアをもっている場合は、 バッキングストアの内容は、上位のウィンドウにより隠されたウィンドウ のリージョンで返されます。 ウィンドウが、バッキングストアをもっていない場合は、 そのような隠されたリージョンについて返される内容については定義されていません。 指定されたウィンドウの深さと異なる深さの下位の ビューアブルなリージョンについて返される内容についても定義されていません。 XGetSubImage は、 BadDrawable、 BadGC、 BadMatch および BadValue エラーを生じることがあります。

診断

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

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

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

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

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

関連事項

Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R