XCreatePixmap(3X11)

名前
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
    ピックスマップの深さを指定。

display
    X サーバへの接続を指定。

pixmap
    ピックスマップを指定。

width

height
    幅と高さを指定。この値はピックスマップのディメンジョンを定義する。

説明
関数 は指定した幅、高さ、深さのピックスマップを生成し、それを一意に示すピッ クスマップIDを返す。 引き数 drawble には のウィンドウを渡しても良い。 ウィンドウの高さと幅はゼロ以外の値でなければならない。 そうでない場合にはエラー となる。 引き数 depth は指定したドロウアブルのスクリーンがサポートしている深さの うちのいずれかでなければならない。そうでない場合には、エラー となる。

X サーバはどのスクリーン上にピックスマップを生成するか決定するため、引き数 で指定されたドロウアブルを利用する。 このピックスマップは他のスクリーン上では使えない。また、異なる深さを持 つドロウアブルと共に使うことはできない(この規則の例外については を参照のこと)。 ピックスマップの内容の初期状態は未定義である。

はエラー を起こすことがある。

関数 は最初にピックスマップIDとピックスマップの関係を削除する。 次に X サーバはピックスマップへの参照が無くなった時に、ピックスマップ のメモリ領域を解放する。 以降はこのピックスマップを参照してはならない。

はエラー を起こすことがある。

返り値

サーバが、要求されたリソースやサーバメモリのアロケートに失敗した。

引き数 Drawable の値が、定義されている Window や Pixmap を指していない。

引き数 Pixmap の値が、定義されている Pixmap を指していない。

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

関連項目
XCopyArea(3X11)
Xlib - C Language X Interface