glTexSubImage2D

glTexSubImage2D 関数は既存のテクスチャ画像の一部を指定する。glTexSubImage2D で新しいテクスチャを定義することはできない。

glTexSubImage2D target, level, xoffset, yoffset, width, height, format, type, pixels

target : [int] 対象テクスチャ。GL_TEXTURE_2D でなければならない。
level : [int] 詳細度レベル番号。レベル 0 が基本イメージ、レベル n は n 段階目のミップマップ縮小画像。
xoffset : [int] テクスチャ配列内の x 方向のテクセルオフセット。
yoffset : [int] テクスチャ配列内の y 方向のテクセルオフセット。
width : [int] テクスチャサブ画像の幅。
height : [int] テクスチャサブ画像の高さ。
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)

解説

glTexSubImage2D 関数は既存のテクスチャ画像の一部を指定する。glTexSubImage2D
で新しいテクスチャを定義することはできない。

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

[備考]
プリミティブの 2 次元テクスチャリングは glEnable / glDisable に GL_TEXTURE_2D
を指定して有効化する。テクスチャリング中は指定したテクスチャ画像の一部が有効な各プリミティブにマップされる。glTexSubImage2D
は既存の 2 次元テクスチャ画像の連続するサブ画像をテクスチャリング用に指定する。pixels が参照するテクセルは、xoffset から
xoffset + (width-1) までの x インデックス、yoffset から yoffset + (height-1) までの
y インデックスの既存テクスチャ配列領域を置き換える。この領域は元のテクスチャ配列の範囲外を含めることはできない。width=0
のサブ画像指定は効果を持たずエラーも生成しない。カラーインデックスモードでは効果を持たない。一般にテクスチャ画像は
GL_STENCIL_INDEX と GL_DEPTH_COMPONENT 以外は glDrawPixels
と同じデータ形式で表現できる。glPixelStore と glPixelTransfer は glDrawPixels
と同じく影響する。関連情報は glGetTexImage、glIsEnabled (GL_TEXTURE_2D) で取得できる。

情報