glTexCoordPointer 関数

glTexCoordPointer 関数は、テクスチャ座標の配列を定義します。

構文

void WINAPI glTexCoordPointer(
         GLint   size,
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

パラメーター

size

配列要素ごとの座標の数。 size の値は、1、2、3、または 4 である必要があります。

type

配列内の各テクスチャ座標のデータ型 。GL_SHORT、GL_INTGL_FLOATGL_DOUBLEの各シンボリック定数を使用します。

stride

連続する配列要素間のバイト オフセット。 stride が 0 の場合、配列要素は配列に密に詰め込まれます。

pointer

配列内の最初の要素の最初の座標へのポインター。

戻り値

この関数は値を返しません。

エラー コード

glGetError 関数では、次のエラー コードを取得できます。

名前 意味
GL_INVALID_ENUM
type は受け入れ可能な値ではありません。
GL_INVALID_VALUE
size は 1、2、3、または 4 ではありません。
GL_INVALID_VALUE
ストライド は否定的でした。

注釈

glTexCoordPointer 関数は、レンダリング時に使用するテクスチャ座標の配列の場所とデータを指定します。size パラメーターは、配列の各要素に使用される座標の数を指定します。type パラメーターは、各テクスチャ座標のデータ型を指定します。 stride パラメーターは、ある配列要素から次の配列要素へのバイト オフセットを決定し、1 つの配列またはストレージ内の頂点と属性を別々の配列にパッキングできるようにします。 一部の実装では、頂点と属性を 1 つの配列に格納する方が、個別の配列を使用するよりも効率的です。 詳細については、「 glInterleavedArrays」を参照してください。 テクスチャ座標配列を指定すると、サイズ、型、ストライド、およびポインターがクライアント側の状態で保存されます。

glEnableClientStateGL_TEXTURE_COORD_ARRAY定数を指定すると、テクスチャ座標配列が有効になります。 有効にすると、 glDrawArraysglDrawElementsおよび glArrayElement でテクスチャ座標配列が使用されます。 既定では、テクスチャ座標配列は無効になっています。

表示リストに glTexCoordPointer を含めることはできません。

glTexCoordPointer を使用してテクスチャ座標配列を指定すると、すべての関数のテクスチャ座標配列パラメーターの値がクライアント側の状態で保存され、静的配列要素をキャッシュできます。 テクスチャ座標配列パラメーターはクライアント側の状態であるため、その値は glPushAttrib および glPopAttrib によって保存または復元されません。

glBeginglEnd のペア内で 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 [デスクトップ アプリのみ]
ヘッダー
Gl.h
ライブラリ
Opengl32.lib
[DLL]
Opengl32.dll

関連項目

glArrayElement

glColorPointer

glDrawArrays

glDrawElements

glEdgeFlagPointer

glEnable

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopClientAttrib

glPushClientAttrib

glTexCoord

glVertexPointer