glGetTexImage

glGetTexImage 関数はテクスチャ画像を返す。

glGetTexImage target, level, format, type, pixels

target : [int] 取得するテクスチャを指定する。GL_TEXTURE_1D と GL_TEXTURE_2D を受け付ける。
level : [int] 目的画像の詳細度レベル番号。レベル 0 が基本イメージレベルで、レベル n は n 段階目のミップマップ縮小画像。
format : [int] 返されるデータのピクセルフォーマット。サポートされるフォーマットは GL_RED、GL_GREEN、GL_BLUE、GL_ALPHA、GL_RGB、GL_RGBA、GL_LUMINANCE、GL_BGR_EXT、GL_BGRA_EXT、GL_LUMINANCE_ALPHA。
type : [int] 返されるデータのピクセル型。サポートされる型は GL_UNSIGNED_BYTE、GL_BYTE、GL_UNSIGNED_SHORT、GL_SHORT、GL_UNSIGNED_INT、GL_INT、GL_FLOAT。
pixels : [intptr] テクスチャ画像を返す。type で指定された型の配列へのポインタであるべき。

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

解説

glGetTexImage 関数はテクスチャ画像を返す。

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

[備考]
glGetTexImage はテクスチャ画像を pixels に返す。target は目的画像が
glTexImage1D(GL_TEXTURE_1D) と glTexImage2D(GL_TEXTURE_2D)
のどちらで指定されたかを示す。level は目的画像の詳細度レベル、format と type
は返される画像配列のフォーマットと型を指定する。受け付ける値の説明はそれぞれ glTexImage1D と glDrawPixels
を参照。glGetTexImage はテクスチャ画像を反転せずに pixels に復元する (つまり画像の左下隅が pixels
の最初の位置になる)。glPixelStore の整列指定はピクセル転送操作と同じくピクセル格納に影響する。glGetTexImage
は表示リストに含められない。テクスチャ画像に割り当てられる精度は実装依存だが、フレームバッファの色精度と同等以上。エラーが生成された場合、pixels
の内容は変更されない。

情報