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函式可以擷取下列錯誤碼。

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

備註

glColorMaterial函式會指定哪些材質參數會追蹤目前的色彩。 當您啟用GL_COLOR_MATERIAL時，針對 臉部所指定的每個材質或材質， 模式 所指定的材質參數或參數會隨時追蹤目前的色彩。 使用 glEnable 和 glDisable函式來啟用和停用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