Функция gluBuild1DMipmaps

Функция gluBuild1DMipmaps создает 1-D MIP-карты.

Синтаксис

void WINAPI gluBuild1DMipmaps(
         GLenum target,
         GLint  components,
         GLint  width,
         GLenum format,
         GLenum type,
   const void   *data
);

Параметры

target

Целевая текстура. Должен быть GL_TEXTURE_1D.

Компоненты

Количество компонентов цвета в текстуре. Значение должно быть 1, 2, 3 или 4.

width

Ширина изображения текстуры.

format

Формат данных в пикселях. Допустимы следующие значения: GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_LUMINANCE или GL_LUMINANCE_ALPHA.

type

Тип данных для данных. Допустимы следующие значения: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT или GL_FLOAT.

data

Указатель на данные изображения в памяти.

Возвращаемое значение

Эта функция не возвращает значение.

Комментарии

Функция gluBuild1DMipmaps получает входное изображение и создает все изображения MIP-карты (с помощью gluScaleImage), чтобы входное изображение можно было использовать в качестве изображения текстуры mipmapped. Затем вызывается функция glTexImage1D для загрузки каждого изображения. Если ширина входного изображения не равна двум, то перед созданием MIP-карт изображение масштабируется до ближайшей мощности из двух.

Возвращаемое нулевое значение указывает на успешное выполнение. В противном случае возвращается код ошибки GLU (см . gluErrorString).

Описание допустимых значений для параметра format см. в разделе glTexImage1D. Описание допустимых значений для параметра типа см. в разделе glDrawPixels.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Glu.h
Библиотека	Glu32.lib
DLL	Glu32.dll

См. также раздел

glDrawPixels

glTexImage1D

gluBuild2DMipmaps

gluScaleImage