glColorMaterial 関数

glColorMaterial 関数を使用すると、マテリアルの色が現在の色を追跡します。

構文

void WINAPI glColorMaterial(
   GLenum face,
   GLenum mode
);

パラメーター

顔

前面、背面、または前面と背面の両方のマテリアル パラメータが現在の色を追跡するかどうかを指定します。 受け入れられる値は、GL_FRONT、GL_BACK、およびGL_FRONT_AND_BACKです。 既定値は GL_FRONT_AND_BACK です。

mode

現在の色を追跡するマテリアル パラメータを指定します。 使用できる値は、GL_EMISSION、GL_AMBIENT、GL_DIFFUSE、GL_SPECULAR、GL_AMBIENT_AND_DIFFUSEです。 既定値は GL_AMBIENT_AND_DIFFUSE です。

戻り値

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

エラー コード

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

名前	意味
GL_INVALID_ENUM	face または mode が受け入れ可能な値ではなかった。
GL_INVALID_OPERATION	glBegin の呼び出しと glEnd の対応する呼び出しの間に関数が呼び出されました。

解説

glColorMaterial 関数は、現在の色を追跡するマテリアル パラメーターを指定します。 GL_COLOR_MATERIALを有効にすると、 面で指定されたマテリアルまたはマテリアルごとに、 モード で指定されたマテリアル パラメータまたはパラメータが常に現在の色を追跡します。 GL_COLOR_MATERIALを引数として呼び出す glEnable 関数と glDisable 関数を使用してGL_COLOR_MATERIALを有効または無効にします。 既定では、GL_COLOR_MATERIALは無効になっています。

glColorMaterial を使用すると、glMaterial を呼び出さずに glColor 関数のみを使用して、各頂点のマテリアル パラメーターのサブセットを変更できます。 各頂点にこのようなパラメーターのサブセットのみを指定する場合は、 glMaterial よりも glColorMaterial を使用することをお勧 めします。

次の関数は 、glColorMaterial に関連する情報を取得します。

引数GL_COLOR_MATERIAL_PARAMETERを含む glGet

引数GL_COLOR_MATERIAL_FACEを含む glGet

glIsEnabled と引数 GL_COLOR_MATERIAL

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Gl.h
ライブラリ	Opengl32.lib
[DLL]	Opengl32.dll

関連項目

glBegin

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial