glGetPixelMapusv 函式
glGetPixelMapfv、glGetPixelMapuiv和glGetPixelMapusv函式會傳回指定的圖元地圖。
語法
void WINAPI glGetPixelMapusv(
GLenum map,
GLushort *values
);
參數
-
map
-
要傳回的圖元對應名稱。 接受的值GL_PIXEL_MAP_I_TO_I、GL_PIXEL_MAP_S_TO_S、GL_PIXEL_MAP_I_TO_R、GL_PIXEL_MAP_I_TO_G、GL_PIXEL_MAP_I_TO_B、GL_PIXEL_MAP_I_TO_A、GL_PIXEL_MAP_R_TO_R、GL_PIXEL_MAP_G_TO_G、GL_PIXEL_MAP_B_TO_B 和 GL_PIXEL_MAP_A_TO_A。
-
值
-
傳回圖元地圖內容。
傳回值
此函式不會傳回值。
錯誤碼
glGetError函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
map 不是可接受的值。 |
|
函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。 |
備註
如需map參數可接受的值描述，請參閱glPixelMap。 glGetPixelMap函式會以地圖中指定的圖元地圖內容傳回值。 在執行 glReadPixels、 glDrawPixels、 glCopyPixels、 glTexImage1D和 glTexImage2D 期間使用圖元對應，將色彩索引、樣板索引、色彩元件和深度元件對應至其他值。
如有要求，不帶正負號的整數值會從內部固定或浮點標記法進行線性對應，讓 1.0 對應到最大的可表示整數值，而 0.0 對應至零。 如果對應值不在 [0，1] 範圍內，則傳回不帶正負號的整數值是未定義的。
若要判斷對應的所需 大小，請使用適當的符號常數呼叫 glGet 。
如果產生錯誤，則不會對 值的內容進行任何變更。
下列函式會擷 取與 glGetPixelMap相關的資訊：
具有引數的glGet GL_PIXEL_MAP_I_TO_I_SIZE
具有引數的glGet GL_PIXEL_MAP_S_TO_S_SIZE
glGet with argument GL_PIXEL_MAP_I_TO_R_SIZE
glGet with argument GL_PIXEL_MAP_I_TO_G_SIZE
具有引數的glGet GL_PIXEL_MAP_I_TO_B_SIZE
具有引數的glGet GL_PIXEL_MAP_I_TO_A_SIZE
glGet with argument GL_PIXEL_MAP_R_TO_R_SIZE
具有引數的glGet GL_PIXEL_MAP_G_TO_G_SIZE
glGet with argument GL_PIXEL_MAP_B_TO_B_SIZE
glGet with argument GL_PIXEL_MAP_A_TO_A_SIZE
glGet with argument GL_MAX_PIXEL_MAP_TABLE
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|