GLCOPYTEXSUBIMAGE1D

Section: Misc. Reference Manual Pages (3G)
索引 xjman

名前

glCopyTexSubImage1D - 1 次元のテクスチャの部分イメージをコピーする

書式

void glCopyTexSubImage1D( GLenum target,


                            GLint level,
                            GLint xoffset,
                            GLint x,
                            GLint y,
                            GLsizei width )

delim $$

引き数

target: 対象となるテクスチャを指定する。 GL_TEXTURE_1D でなければならない。
level: 詳細度(LOD)を指定する。レベル 0 が 0 基本イメージレベルである。レベル n は、n 番目のミップマップ削減イメージである。
xoffset: テクスチャ配列内におけるテクセルのオフセット値を指定する。
x, y: コピーされるピクセル行の左端のウィンドウ座標を指定する。
width: テクスチャ部分イメージの幅を指定する。

説明

glCopyTexSubImage1D は、1 次元のテクスチャイメージの一部を現在の GL_READ_BUFFER から取り出したピクセルで置き換える( メインメモリから取り出す glTexSubImage1D の場合と異なる)。スクリーン並びのピクセル(行の左端の座標が (x, y), 幅が width )は、テクスチャ配列の X 方向のインデックスが xoffset から $"xoffset" ~+~ "width" ~-~ 1$ まで(両端を含む)の部分を置き換える。テクスチャ内の出力先には、元々指定したテクスチャ配列の外にはみ出るテクセルが含まれていてはならない。行に含まれるピクセルは glCopyPixels が呼ばれた場合とまったく同じように処理されるが、処理は最後の変換の直前で終わる。この時点ではピクセルの全ての要素値は [0, 1] の範囲に収まるように調整されている。次に要素値は、テクセル配列に格納するためのテクスチャの内部フォーマットに変換される。幅が 0 の部分テクスチャを指定してもエラーにはならないが、このような指定をしても何も起こらない。現在の GL_READ_BUFFER において、指定された行に含まれるピクセルが現在のレンダリングコンテクストに関連づけされたウィンドウの外にある場合、そのピクセルについて得られる値は未定義である。指定されたテクスチャ配列の internalformat, width, border パラメータや、指定された部分領域の外にあるテクセル値への変更は行われない。

注意

glCopyTexImage1D は GL の 1.1 以降でしか利用できない。テクスチャ処理は色インデックスモードでは効果がない。 glPixelStore モードと glPixelTransfer モードがテクスチャイメージに与える影響は、これらのモードが glDrawPixels に与える影響とまったく同じである。 GL_ARB_imaging 機能拡張に対応していれば、フレームバッファからコピーされた RGBA 要素はイメージ処理パイプラインによって処理される場合がある。詳しい説明については glTexImage1D を参照すること。

エラー

GL_INVALID_ENUM: target が GL_TEXTURE_1D でない場合に起こる。 GL_INVALID_OPERATION: テクスチャ配列が予め glTexImage1D 操作または glCopyTexImage1D 操作を使って定義されていない場合に起こる。 GL_INVALID_VALUE: level が 0 より小さい場合に起こる。 GL_INVALID_VALUE: level$>log sub 2$ max の場合に起こることがある。ここで $max$ は GL_MAX_TEXTURE_SIZE が返す値である。 GL_INVALID_VALUE: y$ ~<~ ~-b$ または width$ ~<~ ~-b$ の場合に起こる。ここで $b$ はテクスチャ配列の境界幅である。 GL_INVALID_VALUE: $"xoffset" ~<~ ~-b$ または $("xoffset"~+~"width") ~>~ (w-b)$ の場合に起こる。ここで $w$ , $b$ は修正されるテクスチャイメージの GL_TEXTURE_WIDTH および GL_TEXTURE_BORDER である。 $w$ は境界幅を 2 回分含む点に注意すること。

jman

Time: 07:01:06 GMT, January 12, 2009

GLCOPYTEXSUBIMAGE1D

名前

書式

引き数

説明

注意

エラー

関連する取得値

関連項目

Index