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函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
臉部 或 模式 不是可接受的值。 |
|
函式是在 對 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 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|