glColorMaterial 函式

glColorMaterial函式會讓材質色彩追蹤目前的色彩。

語法

void WINAPI glColorMaterial(
   GLenum face,
   GLenum mode
);

參數

指定 front、back 或 front 和 back 材質參數是否應該追蹤目前的色彩。 接受的值是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函式可以擷取下列錯誤碼。

Name 意義
GL_INVALID_ENUM
臉部模式 不是可接受的值。
GL_INVALID_OPERATION
函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glColorMaterial函式會指定哪些材質參數會追蹤目前的色彩。 當您啟用GL_COLOR_MATERIAL時,針對 臉部所指定的每個材質或材質, 模式 所指定的材質參數或參數會隨時追蹤目前的色彩。 使用 glEnableglDisable函式來啟用和停用GL_COLOR_MATERIAL,您可以使用 GL_COLOR_MATERIAL 作為其引數來呼叫。 預設會停用GL_COLOR_MATERIAL。

使用 glColorMaterial,您可以只使用 glColor 函式來變更每個頂點的材質參數子集,而不需呼叫 glMaterial。 如果您只針對每個頂點指定這類參數子集,最好是使用 glColorMaterial 來執行此動作,而不是 glMaterial

下列函式會擷 取與 glColorMaterial相關的資訊:

glGet with argument GL_COLOR_MATERIAL_PARAMETER

具有引數的glGet GL_COLOR_MATERIAL_FACE

glIsEnabled with argument 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