glCopyTexSubImage1D 関数
glCopyTexSubImage1D 関数は、フレームバッファーから 1 次元テクスチャ イメージのサブイメージをコピーします。
構文
void WINAPI glCopyTexSubImage1D(
GLenum target,
GLint level,
GLint xoffset,
GLint x,
GLint y,
GLsizei width
);
パラメーター
-
target
-
イメージ データの変更先となるターゲット。 値をGL_TEXTURE_1Dする必要があります。
-
level
-
詳細レベル番号。 レベル 0 は基本イメージです。 レベル n は n番目のミップマップ縮小画像である。
-
xoffset
-
テクスチャ配列内のテクセル オフセット。
-
x
-
コピーするピクセルの行の左下隅のウィンドウ x 平面座標。
-
y
-
コピーするピクセルの行の左下隅のウィンドウ y 平面座標。
-
width
-
テクスチャ イメージのサブイメージの幅。 幅がゼロのテクスチャ サブイメージを指定しても効果はありません。
戻り値
この関数は値を返しません。
エラー コード
glGetError 関数では、次のエラー コードを取得できます。
| 名前 | 意味 |
|---|---|
|
target が受け入れられた値ではありません。 |
|
level が 0 より小さいか 、または level が ログ2 (max) より大きく、 max は GL_MAX_TEXTURE_SIZE の戻り値です。 |
|
xoffset が罫線より小さいか (xoffset + の幅)が (w罫線) より大きく、w + がGL_TEXTURE_WIDTH、罫線がGL_TEXTURE_BORDER。
w には罫線の幅の 2 倍が含まれていることに注意してください。 |
|
width が 罫線 より小さいか 、y が 罫線より小さく、 border はテクスチャ配列の境界線の幅です。 |
|
テクスチャ配列は、以前の glTexImage1D 操作で定義されませんでした。 |
|
glBegin の呼び出しと glEnd の対応する呼び出しの間に関数が呼び出されました。 |
解説
glCopyTexSubImage1D 関数は、glTexSubImage1D の場合と同様に、現在のフレームバッファーのピクセルを使用して 1 次元テクスチャ イメージの一部メイン置き換えます。
x と y で指定されたウィンドウ座標で始まり、長さ幅で始まるピクセルの行は、テクスチャ配列の部分を xoffset + (width - 1) を介したインデックス xoffset に置き換えます。 テクスチャ配列内のコピー先には、最初に指定したテクスチャ配列の外側にテクセルを含めることはできません。
glCopyTexSubImage1D 関数は、glCopyPixels と同じ方法で行内のピクセルを処理します。ただし、ピクセルの最終的な変換の前に、すべてのピクセル コンポーネント値が範囲 [0,1] に固定され、テクスチャ配列に格納されるテクスチャの内部形式に変換されます。 ピクセルの順序は、低いテクスチャ座標に対応する低い x 座標で決定されます。 現在のフレームバッファーの指定された行内のピクセルのいずれかが、現在のレンダリング コンテキストに関連付けられているウィンドウの外側にある場合、それらの値は未定義になります。
指定したテクスチャ配列の internalFormat、 width、または border パラメーターや、指定したテクスチャ サブイメージの外部のテクセル値は変更されません。
glCopyTexSubImage1D の呼び出しを表示リストに含めることはできません。
注意
glCopyTexSubImage1D 関数は、OpenGL バージョン 1.1 以降でのみ使用できます。
テクスチャリングは、カラー インデックス モードでは効果がありません。 glPixelStore 関数と glPixelTransfer 関数は、glDrawPixels を使用してピクセルの描画方法に正確に影響を与えるテクスチャ イメージに影響します。
次の関数は 、glCopyTexSubImage1D に関連する情報を取得します。
引数GL_TEXTURE_1Dを使用した glIsEnabled
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|