glColor4sv 函式
從現有的色彩值陣列設定目前的色彩。
語法
void WINAPI glColor4sv(
const GLshort *v
);
參數
-
v
-
陣列的指標，其中包含紅色、綠色、藍色和 Alpha 值。
傳回值
此函式不會傳回值。
備註
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 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|