glReadPixels

glReadPixels 関数はフレームバッファからピクセルブロックを読み込む。

glReadPixels x, y, width, height, format, type, pixels

x : [int] フレームバッファから読まれる最初のピクセルのウィンドウ x 座標。y 座標と合わせて矩形ピクセルブロックの左下隅の位置を指定する。
y : [int] フレームバッファから読まれる最初のピクセルのウィンドウ y 座標。x 座標と合わせて矩形ピクセルブロックの左下隅の位置を指定する。
width : [int] ピクセル矩形の幅。
height : [int] ピクセル矩形の高さ。width / height が 1 の場合は単一ピクセルに対応する。
format : [int] ピクセルデータのフォーマット。受け付ける主な値: GL_COLOR_INDEX (カラーインデックス。固定小数化、GL_INDEX_SHIFT/OFFSET 適用後 GL_PIXEL_MAP_I_TO_R/G/B/A で色成分に変換)、GL_STENCIL_INDEX (ステンシル値。glReadPixels 用)、GL_DEPTH_COMPONENT (デプス値。浮動小数化し GL_DEPTH_SCALE/BIAS を適用後 [0,1] にクランプ)、GL_RED/GL_GREEN/GL_BLUE/GL_ALPHA (それぞれ単一成分を浮動小数化して RGBA 要素に組み立て、scale/bias 適用後クランプ)、GL_RGB (RGB トリプル)、GL_RGBA (完全 RGBA)、GL_BGR_EXT/GL_BGRA_EXT (Windows DIB のメモリレイアウトに一致するフォーマット)、GL_LUMINANCE (単一輝度値を R/G/B に複製しアルファに 1.0 を付加)、GL_LUMINANCE_ALPHA (輝度/アルファペア)。
type : [int] ピクセルデータのデータ型。次のいずれかを指定する: GL_UNSIGNED_BYTE、GL_BYTE、GL_BITMAP、GL_UNSIGNED_SHORT、GL_SHORT、GL_UNSIGNED_INT、GL_INT、GL_FLOAT。それぞれのインデックスマスクと成分変換式は元の表を参照。
pixels : [intptr] ピクセルデータを返す。

(プラグイン / モジュール : opengl32.dll)

解説

glReadPixels 関数はフレームバッファからピクセルブロックを読み込む。

[戻り値]
この関数は値を返さない。

情報