glColor4us 函式

設定目前的色彩。

語法

void WINAPI glColor4us(
   GLushort red,
   GLushort green,
   GLushort blue,
   GLushort alpha
);

參數

red

目前色彩的新紅色值。

green

目前色彩的新綠色值。

blue

目前色彩的新藍色值。

alpha

目前色彩的新 Alpha 值。

傳回值

此函式不會傳回值。

備註

GL 會同時儲存目前的單一值色彩索引和目前的四值 RGBA 色彩。 glcolor 會設定新的四值 RGBA 色彩。 glcolor 有兩個主要變體： glcolor3 和 glcolor4。 glcolor3 變體會明確指定新的紅色、綠色和藍色值，並將目前的 Alpha 值設定為 1.0 (隱含的完整濃度) 。 glcolor4 變體會明確指定所有四個色彩元件。

glcolor3b、glcolor4b、glcolor3s、glcolor4s、glcolor3i和glcolor4i會採用三或四個帶正負號的位元組、簡短或長整數作為引數。 當 v 附加至名稱時，色彩命令可以取得這類值的陣列指標。

目前的色彩值會以浮點格式儲存，並具有未指定的 mantissa 和指數大小。 指定時，不帶正負號的整數色彩元件會以線性方式對應至浮點值，讓最大可表示值對應至 1.0 (完整濃度) ，而 0 則對應至 0.0 (零濃度) 。 指定時，帶正負號的整數色彩元件會以線性方式對應至浮點值，讓最正表示的值對應至 1.0，而最負數表示的值會對應至 -1.0。 (請注意，此對應不會精確地將 0 轉換為 0.0.) 浮點值直接對應。

在更新目前色彩之前，浮點數或帶正負號的整數值都不會限制在範圍 [0，1]。 不過，色彩元件會在插入或寫入色彩緩衝區之前，先將色彩元件固定到此範圍。

規格需求

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

另請參閱

glBegin

glEnd

glGetBooleanv、glGetDoublev、glGetFloatv、glGetIntegerv

glIndex