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