Функция glGetTexLevelParameteriv

Статья
06/13/2023

Функции glGetTexLevelParameterfv и glGetTexLevelParameteriv возвращают значения параметров текстуры для определенного уровня детализации.

Синтаксис

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

Параметры

target

Символическое имя целевой текстуры: GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D или GL_PROXY_TEXTURE_2D.

level

Номер уровня детализации нужного изображения. Уровень 0 — это базовый уровень образа. Уровень n — это изображениеn-го сокращения MIP-карты.

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	Разрешение внутреннего хранилища альфа-компонента текселя. Разрешение, выбранное 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 меньше нуля или больше , чем в журнале2(max), где max — возвращаемое значение GL_MAX_TEXTURE_SIZE.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Функция glGetTexLevelParameter возвращает значения параметров текстуры params для определенного значения уровня детализации, указанного в качестве уровня. Параметр target определяет целевую текстуру 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

Поделиться через