GLXCREATEGLXPIXMAP

名前
glXCreateGLXPixmap - オフスクリーンの GLX レンダリング領域を生成する

C SPECIFICATION
GLXPixmap glXCreateGLXPixmap( Display *dpy,
	XVisualInfo *vis,
	Pixmap pixmap )

書式

dpy X サーバへの接続を指定する。

vis レンダリング領域の構造を定義するビジュアルを指定する。 これは XVisualInfo 構造体へのポインタであり、ビジュアルの ID や Visual へのポインタではない。

pixmap
    オフスクリーンレンダリング領域の前面左のカラーバッファとして使われる X ピックスマップを指定する。

説明
glXCreateGLXPixmap はオフスクリーンのレンダリング領域を生成し、 その XID を返す。 vis について生成された任意の GLX レンダリングコンテクストを使っ て、このオフスクリーン領域にレンダリングを行うことができる。 レンダリング領域と GLX レンダリングコンテクストを関連付けるには、 glXMakeCurrent を用いる。

pixmap で識別される X ピックスマップは、得られるオフスクリーンレ ンダリング領域の前面左のバッファとして使われます。 vis で指定された他の全てのバッファ(前面左のバッファ以外のカラー バッファを含む)は、外から見える名前を使わないで生成される。 ダブルバッファである GLX ピックスマップはサポートされている。 しかし、これらのピックスマップでは glXSwapBuffers は無視される。

一部の実装では、直接レンダリングコンテクストを使う GLX ピックスマップ はサポートされていない。

注意
XVisualInfo は Xutil.h において定義されている。 これは visual, visualID, screen, depth 要素を 持つ構造体である。

エラー
pixmap の深さが、X11 のコアが vis に対して報告する深さと 一致しない場合、または pixmap が vis と同じスクリーンにつ いて生成されていない場合には BadMatch が生成される。

vis が有効な XVisualInfo のポインタでない場合(例えば、特定の GLX の実装はこのビジュアルをサポートしていない場合)には BadValue が 生成される。

pixmap が有効なピックスマップでない場合には BadPixmap が生 成される。

サーバが GLX ピックスマップを割り当てられない場合には BadAlloc が生成される。

関連項目
glXCreateContext, glXIsDirect, glXMakeCurrent