glColorPointer 関数
glColorPointer 関数は、色の配列を定義します。
構文
void WINAPI glColorPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
パラメーター
-
size
-
色ごとのコンポーネントの数。 値は 3 または 4 である必要があります。
-
type
-
カラー配列内の各色コンポーネントのデータ型。 使用できるデータ型は、GL_BYTE、GL_UNSIGNED_BYTE、GL_SHORT、GL_UNSIGNED_SHORT、GL_INT、GL_UNSIGNED_INT、GL_FLOAT、GL_DOUBLEの各定数で指定します。
-
stride
-
連続する色間のバイト オフセット。 ストライドが 0 の場合、色は配列に密に詰められます。
-
pointer
-
カラー配列内の最初のカラー要素の最初のコンポーネントへのポインター。
戻り値
この関数は値を返しません。
エラー コード
glGetError 関数では、次のエラー コードを取得できます。
| Name | 意味 |
|---|---|
|
size が 3 または 4 でなかった。 |
|
type が受け入れられた値ではありません。 |
|
ストライド または カウント が負の値でした。 |
注釈
glColorPointer 関数は、レンダリング時に使用するカラー コンポーネントの配列の場所とデータ形式を指定します。 stride パラメーターは、ある色から次の色へのバイト オフセットを決定し、1 つの配列または個別の配列内のストレージに頂点属性をパッキングできるようにします。 一部の実装では、頂点属性を 1 つの配列に格納する方が、個別の配列を使用するよりも効率的です。
glEnableClientState でGL_COLOR_ARRAY定数を指定して、カラー配列を有効にしました。 glArrayElement、glDrawElements、または glDrawArrays を呼び出すと、有効になっているカラー配列が使用されます。 既定では、カラー配列は無効になっています。 glColorPointer の呼び出しは、表示リストに入力してもできません。
glColorPointer を使用してカラー配列を指定すると、すべての関数のカラー配列パラメーターの値がクライアント側の状態で保存され、静的配列要素をキャッシュできます。 カラー配列パラメーターはクライアント側の状態であるため、 glPushAttrib と glPopAttrib はパラメーターの値を保存または復元しません。
glBegin と glend のペア内でカラー配列を指定してもエラーは生成されませんが、結果は未定義です。
次の関数は 、glColorPointer 関数に関連する情報を取得します。
glIsEnabled と引数 GL_COLOR_ARRAY
引数GL_COLOR_ARRAY_SIZEを含む glGet
引数GL_COLOR_ARRAY_TYPEを含む glGet
glGet と引数 GL_COLOR_ARRAY_STRIDE
glGet と引数 GL_COLOR_ARRAY_COUNT
引数がGL_COLOR_ARRAY_POINTERされた glGetPointerv
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|