Функция glGetTexLevelParameterfv

Статья
06/13/2023

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

Синтаксис

void WINAPI glGetTexLevelParameterfv(
   GLenum  target,
   GLint   level,
   GLenum  pname,
   GLfloat *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	уровень меньше нуля или больше журнала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

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