Функция gluScaleImage

Функция gluScaleImage масштабирует изображение до произвольного размера.

Синтаксис

int WINAPI gluScaleImage(
         GLenum format,
         GLint  widthin,
         GLint  heightin,
         GLenum typein,
   const void   *datain,
         GLint  widthout,
         GLint  heightout,
         GLenum typeout,
         void   *dataout
);

Параметры

format

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

widthin

Ширина масштабируемого исходного изображения.

heightin

Высота исходного изображения, масштабируемого.

typein

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

datain

Указатель на исходное изображение.

widthout

Ширина целевого изображения.

heightout

Высота целевого изображения.

typeout

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

dataout

Указатель на целевое изображение.

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

Если вызов функции заканчивается удачно, возвращается нулевое значение.

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

Комментарии

Функция gluScaleImage масштабирует пиксельное изображение с помощью соответствующих режимов хранения пикселей для распаковки данных из исходного изображения и упаковки данных в целевое изображение.

При сжатии изображения gluScaleImage использует фильтр полей для выборки исходного изображения и создания пикселей для целевого изображения. При увеличении изображения пиксели исходного изображения линейно интерполируются для создания целевого изображения.

Описание допустимых значений для параметров format, typein и typeout см. в разделе glReadPixels.

Требования

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

glDrawPixels

glReadPixels

gluBuild1DMipmaps

gluBuild2DMipmaps

gluErrorString