glColor3usv 函式

  • 發行項

從現有的色彩值陣列設定目前的色彩。

語法

void WINAPI glColor3usv(
   const GLushort *v
);

參數

v

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

傳回值

此函式不會傳回值。

備註

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

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

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

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

規格需求

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

另請參閱

glBegin

glEnd

glGetBooleanv、glGetDoublev、glGetFloatv、glGetIntegerv

glIndex