XCreatePixmap

Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.3
Index xjman/web INDEX

名前

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: 幅と高さを指定。この値はピックスマップのディメンジョンを定義する。

説明

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

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

XCreatePixmap はエラー BadAlloc, BadDrawable, BadValue を起こすことがある。

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

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

返り値

BadAlloc: 要求されたリソースやサーバメモリの割り当てにサーバが失敗した。
BadDrawable: 引き数 Drawable の値が、定義されている Window や Pixmap を指していない。
BadPixmap: 引き数 Pixmap の値が、定義されている Pixmap を指していない。
BadValue: 指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範囲が許される。選択肢として定義されている引き数はこのエラーを起こすことがある。

This document was created by man2html, using the manual pages.
Time: 15:55:32 GMT, February 12, 2001

XCreatePixmap

名前

書式

引き数

説明

返り値

関連項目

Index