glGetPixelMapuiv 函式

glGetPixelMapfv、glGetPixelMapuiv和glGetPixelMapusv函式會傳回指定的圖元對應。

語法

void WINAPI glGetPixelMapuiv(
   GLenum map,
   GLuint *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函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_ENUM	map 不是接受的值。
GL_INVALID_OPERATION	在對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

如需map參數可接受的值描述，請參閱glPixelMap。 glGetPixelMap函式會傳回地圖中所指定圖元地圖的內容值。在執行glReadPixels、glDrawPixels、glCopyPixels、glTexImage1D和glTexImage2D期間使用圖元對應，將色彩索引、樣板索引、色彩元件和深度元件對應至其他值。

如有要求，不帶正負號的整數值會從內部固定或浮點標記法進行線性對應，讓 1.0 對應至最大的可表示整數值，而 0.0 會對應至零。如果對應值不在範圍 [0，1] 中，則傳回不帶正負號的整數值未定義。

若要判斷所需的地圖大小，請使用適當的符號常數呼叫 glGet 。

如果產生錯誤，則不會對值的內容進行任何變更。

下列函式會擷取 與 glGetPixelMap相關的資訊：

glGet with argument 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 搭配引數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 搭配引數GL_PIXEL_MAP_A_TO_A_SIZE

glGet with argument GL_MAX_PIXEL_MAP_TABLE