glGetColorTableParameterivEXT 函式
glGetColorTableParameterfvEXT和glGetColorTableParameterivEXT函式會從色彩資料表取得調色盤參數。
語法
void WINAPI glGetColorTableParameterivEXT(
GLenum target,
GLenum pname,
GLint *params
);
參數
-
目標
-
您想要參數資料之調色盤的目標紋理。 必須是TEXTURE_1D、TEXTURE_2D、PROXY_TEXTURE_1D或PROXY_TEXTURE_2D。
-
pname
-
參數所指向之調色盤參數資料類型的符號常 數。
以下是可接受的符號常數及其意義。
值 意義 - GL_COLOR_TABLE_FORMAT_EXT
傳回最近呼叫 glColorTableEXT 或預設值所指定的內部格式。 - GL_COLOR_TABLE_WIDTH_EXT
傳回目前調色盤的寬度。 - GL_COLOR_TABLE_RED_SIZE_EXT
傳回內部用來儲存調色盤資料紅色元件的實際大小。 - GL_COLOR_TABLE_GREEN_SIZE_EXT
傳回內部用來儲存調色盤資料的綠色元件的實際大小。 - GL_COLOR_TABLE_BLUE_SIZE_EXT
傳回內部用來儲存調色盤資料的藍色元件的實際大小。 - GL_COLOR_TABLE_ALPHA_SIZE_EXT
傳回內部用來儲存調色盤資料 Alpha 元件的實際大小。 -
params
-
指向 pname 參數所指定的色彩資料表參數資料。
傳回值
此函式不會傳回值。
備註
您可以使用 glGetColorTableParameterivEXT 和 glGetColorTableParameterfvEXT 函式，從以 glColorTableEXT 設定的色彩資料表擷取特定參數資料，以取得目標紋理調色盤。 您也可以使用這些函式來判斷 glGetColorTableEXT 傳回的色彩表格專案數目。
當 目標 參數GL_PROXY_TEXTURE_1D或GL_PROXY_TEXTURE_2D，而且實作不支援針對 格式 或 寬度指定的值時， glColorTableEXT 無法建立要求的色彩表。 在此情況下，色彩表是空的，而且擷取的所有參數都會是零。 您可以使用 Proxy 目標呼叫glColorTableEXT，然後呼叫glGetColorTableParameterivEXT 或 glGetColorTableParameterfvEXT來判斷 width 參數是否符合glColorTableEXT所設定的特定色彩資料表格式和大小。 如果擷取的寬度為零， glColorTable 的色彩表格要求就會失敗。 如果擷取的寬度不是零，您可以使用TEXTURE_1D或TEXTURE_2D來呼叫 glColorTable 來設定色彩表格。
glGetColorTableParameterivEXT和glGetColorTableParameterfvEXT函式是不屬於標準 OpenGL 程式庫但屬於GL_EXT_paletted_texture延伸模組的延伸模組函式。 若要檢查 OpenGL 的實作是否支援glGetColorTableParameterivEXT和glGetColorTableParameterfvEXT，請呼叫glGetString (GL_EXTENSIONS) 。 如果傳回GL_EXT_paletted_texture， 則支援 glGetColorTableParameterivEXT 和 glGetColorTableParameterfvEXT 。 若要取得擴充函式的函式位址，請呼叫 wglGetProcAddress。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 |
|