glTexCoordPointer 関数
glTexCoordPointer 関数は、テクスチャ座標の配列を定義します。
構文
void WINAPI glTexCoordPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
パラメーター
-
size
-
配列要素ごとの座標の数。 size の値は、1、2、3、または 4 である必要があります。
-
type
-
配列内の各テクスチャ座標のデータ型 。GL_SHORT、GL_INT、GL_FLOAT、GL_DOUBLEの各シンボリック定数を使用します。
-
stride
-
連続する配列要素間のバイト オフセット。 stride が 0 の場合、配列要素は配列に密に詰め込まれます。
-
pointer
-
配列内の最初の要素の最初の座標へのポインター。
戻り値
この関数は値を返しません。
エラー コード
glGetError 関数では、次のエラー コードを取得できます。
| 名前 | 意味 |
|---|---|
|
type は受け入れ可能な値ではありません。 |
|
size は 1、2、3、または 4 ではありません。 |
|
ストライド は否定的でした。 |
注釈
glTexCoordPointer 関数は、レンダリング時に使用するテクスチャ座標の配列の場所とデータを指定します。size パラメーターは、配列の各要素に使用される座標の数を指定します。type パラメーターは、各テクスチャ座標のデータ型を指定します。 stride パラメーターは、ある配列要素から次の配列要素へのバイト オフセットを決定し、1 つの配列またはストレージ内の頂点と属性を別々の配列にパッキングできるようにします。 一部の実装では、頂点と属性を 1 つの配列に格納する方が、個別の配列を使用するよりも効率的です。 詳細については、「 glInterleavedArrays」を参照してください。 テクスチャ座標配列を指定すると、サイズ、型、ストライド、およびポインターがクライアント側の状態で保存されます。
glEnableClientState でGL_TEXTURE_COORD_ARRAY定数を指定すると、テクスチャ座標配列が有効になります。 有効にすると、 glDrawArrays、 glDrawElements、 および glArrayElement でテクスチャ座標配列が使用されます。 既定では、テクスチャ座標配列は無効になっています。
表示リストに glTexCoordPointer を含めることはできません。
glTexCoordPointer を使用してテクスチャ座標配列を指定すると、すべての関数のテクスチャ座標配列パラメーターの値がクライアント側の状態で保存され、静的配列要素をキャッシュできます。 テクスチャ座標配列パラメーターはクライアント側の状態であるため、その値は glPushAttrib および glPopAttrib によって保存または復元されません。
glBegin と glEnd のペア内で glTexCoordPointer を呼び出してもエラーは生成されませんが、結果は未定義です。
次の関数は 、glTexCoordPointer に関連する情報を取得します。
引数GL_TEXTURE_COORD_ARRAYを使用した glIsEnabled
引数GL_TEXTURE_COORD_ARRAY_SIZEを含む glGet
引数GL_TEXTURE_COORD_ARRAY_STRIDEを含む glGet
引数GL_TEXTURE_COORD_ARRAY_COUNTを含む glGet
引数GL_TEXTURE_COORD_ARRAY_TYPEを含む glGet
引数GL_TEXTURE_COORD_ARRAY_POINTERを含む glGetPointerv
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|