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
-
指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範
囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが
ある。
関連項目
XCopyArea(3X11)
Xlib - C Language X Interface
Index
- 名前
-
- 書式
-
- 引き数
-
- 説明
-
- 返り値
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.
Time: 15:55:32 GMT, February 12, 2001