Функция gluBuild2DMipmaps

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

Синтаксис

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

Параметры

target

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

Компоненты

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

width

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

height

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

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

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

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

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

Комментарии

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

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

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

Требования

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

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage