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 意味
GL_INVALID_VALUE
 size が 3 または 4 でなかった。
GL_INVALID_ENUM
 type が受け入れられた値ではありません。
GL_INVALID_VALUE
 ストライド または カウント が負の値でした。

注釈

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

こちらもご覧ください

glArrayElement

glBegin

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glEnd

glGet

glGetString

glGetPointerv

glIndexPointer

glIsEnabled

glNormalPointer

glPopAttrib

glPushAttrib

glTexCoordPointer

glVertexPointer