名称

XCreatePixmap, XFreePixmap − ピクスマップを生成または破壊する

形式

Pixmap XCreatePixmap(display, d, width, height, depth)
      Display ∗display;
      Drawable d;
      unsigned int width, height;
      unsigned int depth; XFreePixmap(display, pixmap)
      Display ∗display;
      Pixmap pixmap;

引数

dどのスクリーンでピクスマップを生成するかを指定します。

depthピクスマップの深さを指定します。

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

pixmapピクスマップを指定します。

width

height幅と高さを指定し、ピクスマップの寸法を定義します。

解説

XCreatePixmap 関数は、指定した幅、高さおよび深さのピクスマップを生成し、 ピクスマップを識別するピクスマップ ID を返します。 InputOnly ウィンドウを drawable 引数に渡すと効果的です。 width および height 引数は 0 でない値でなければなりません。 さもなければ BadValue エラーが生じます。 depth 引数は、指定された drawable のスクリーンでサポートできる 深さのひとつでなければなりません。 さもなければ BadValue エラーが生じます。 サーバは、指定された drawable を使用し、どのスクリーンで ピクスマップを生成するかを判断します。 ピクスマップは、このスクリーンでしか使用できず、 他の同じ深さの drawable とともに使用することしかできません (この規則の例外については、 XCopyPlane を参照してください)。 ピクスマップの初期内容は未定義です。 XCreatePixmap は、 BadAlloc、 BadDrawable および BadValue エラーを生じることがあります。 XFreePixmap 関数は、最初にピクスマップ ID と ピクスマップとの対応付けを削除します。 次に、X サーバは、参照がない場合、ピクスマップ記憶領域を 解放します。 ピクスマップは、再び参照されるべきではありません。 XFreePixmap は、 BadPixmap エラーを生じることがあります。

診断

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

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

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

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

関連事項

XCopyArea(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R