glColor3bv 函式

從已存在的色彩值陣列設定目前的色彩。

語法

void WINAPI glColor3bv(
   const GLbyte *v
);

參數

v

陣列的指標,其中包含紅色、綠色和藍色值。

傳回值

此函式不會傳回值。

備註

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

glcolor3b、glcolor4bglcolor3sglcolor4sglcolor3iglcolor4i會採用三或四個帶正負號的位元組、簡短或長整數作為引數。 當 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