glGetTexLevelParameteriv 函式

glGetTexLevelParameterfv和glGetTexLevelParameteriv函式會傳回特定詳細層級的紋理參數值。

語法

void WINAPI glGetTexLevelParameteriv(
   GLenum target,
   GLint  level,
   GLenum pname,
   GLint  *params
);

參數

目標

目標紋理的符號名稱：GL_TEXTURE_1D、GL_TEXTURE_2D、GL_PROXY_TEXTURE_1D或GL_PROXY_TEXTURE_2D。

level

所需影像的詳細資料層級數目。 層級 0 是基底映射層級。 層級 n 是 第 n個 mipmap 縮減影像。

pname

紋理參數的符號名稱。 接受下列參數名稱。

值	意義
GL_TEXTURE_WIDTH	params參數會傳回包含紋理影像寬度的單一值。 此值包含紋理影像的框線。
GL_TEXTURE_HEIGHT	params參數會傳回包含紋理影像高度的單一值。 此值包含紋理影像的框線。
GL_TEXTURE_INTERNAL_FORMAT	params參數會傳回單一值，描述紋理的紋素格式。
GL_TEXTURE_BORDER	params參數會傳回單一值：紋理影像框線的圖元寬度。
GL_TEXTURE_RED_SIZE	紋素之紅色元件的內部儲存解析度。 OpenGL 選擇的解析度將會與使用者要求的解析度相符，以及 glTexImage1D 或 glTexImage2D的元件引數。
GL_TEXTURE_GREEN_SIZE	紋素綠色元件的內部儲存解析度。 OpenGL 選擇的解析度將會與使用者要求的解析度相符，以及 glTexImage1D 或 glTexImage2D的元件引數。
GL_TEXTURE_BLUE_SIZE	紋素之藍色元件的內部儲存解析度。 OpenGL 選擇的解析度將會與使用者要求的解析度相符，以及 glTexImage1D 或 glTexImage2D的元件引數。
GL_TEXTURE_ALPHA_SIZE	紋素 Alpha 元件的內部儲存解析度。 OpenGL 選擇的解析度將會與使用者要求的解析度相符，以及 glTexImage1D 或 glTexImage2D的元件引數。
GL_TEXTURE_LUMINANCE_SIZE	紋素之亮度元件的內部儲存解析度。 OpenGL 選擇的解析度將會與使用者要求的解析度相符，以及 glTexImage1D 或 glTexImage2D的元件引數。
GL_TEXTURE_INTENSITY_SIZE	材質強度元件的內部儲存解析度。 OpenGL 選擇的解析度將會與使用者要求的解析度相符，以及 glTexImage1D 或 glTexImage2D的元件引數。
GL_TEXTURE_COMPONENTS	params參數會傳回單一值：紋理影像中的元件數目。

params

傳回要求的資料。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_ENUM	target 或 pname 不是可接受的值。
GL_INVALID_VALUE	level 小於零或大於 log2* (max) *，其中 max 是傳回GL_MAX_TEXTURE_SIZE的值。
GL_INVALID_OPERATION	函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glGetTexLevelParameter函式會針對指定為層級的特定詳細資料層級值，傳回params紋理參數值。 目標參數會定義目標紋理、GL_TEXTURE_1D、GL_TEXTURE_2D、GL_PROXY_TEXTURE_1D或GL_PROXY_TEXTURE_2D，以指定一維或二維文字。 pname參數會指定會傳回其值或值的紋理參數。

如果產生錯誤，則 不會變更參數的內容。

規格需求

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

另請參閱

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter