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

返回请求的数据。

返回值

此函数不返回值。

错误代码

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