glColorMask 函式

glColorMask 函式會啟用和停用畫面緩衝區色彩元件的寫入。

語法

void WINAPI glColorMask(
   GLboolean red,
   GLboolean green,
   GLboolean blue,
   GLboolean alpha
);

參數

red

指定紅色是否可以寫入框架緩衝區。 預設值為 GL_TRUE，表示可以寫入色彩元件。

green

指定綠色是否可以寫入框架緩衝區。 預設值為 GL_TRUE，表示可以寫入色彩元件。

blue

指定藍色是否可以寫入框架緩衝區。 預設值為 GL_TRUE，表示可以寫入色彩元件。

alpha

指定 Alpha 是否可以或無法寫入框架緩衝區。 預設值為 GL_TRUE，表示可以寫入色彩元件。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_OPERATION	函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glColorMask 函式會指定框架緩衝區中的個別色彩元件是否可以寫入或無法寫入。 例如，如果 紅色 是GL_FALSE，則不論嘗試繪圖作業為何，都不會變更任何色彩緩衝區中任何圖元的紅色元件。

無法控制個別元件位的變更。 相反地，會針對整個色彩元件啟用或停用變更。

下列函式會擷 取與 glColorMask相關的資訊：

glGet with argument GL_COLOR_WRITEMASK

具有引數的glGet GL_RGBA_MODE

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Gl.h
程式庫	Opengl32.lib
DLL	Opengl32.dll

另請參閱

glBegin

glColor

glDepthMask

glEnd

glGet

glIndex

glIndexMask

glStencilMask