Função gluScaleImage

A função gluScaleImage dimensiona uma imagem para um tamanho arbitrário.

Sintaxe

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

Parâmetros

format

O formato dos dados de pixel. Os seguintes valores simbólicos são válidos: 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 e GL_LUMINANCE_ALPHA.

widthin

A largura da imagem de origem que é dimensionada.

heightin

A altura da imagem de origem que é dimensionada.

typein

O tipo de dados para datain. Deve ser um dos seguintes: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT ou GL_FLOAT.

datain

Um ponteiro para a imagem de origem.

widthout

A largura da imagem de destino.

heightout

A altura da imagem de destino.

typeout

O tipo de dados para o dataout. Deve ser um dos seguintes: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT ou GL_FLOAT.

dataout

Um ponteiro para a imagem de destino.

Valor retornado

Se a função obtiver êxito, o valor retornado será zero.

Se a função falhar, o valor retornado será um código de erro GLU (consulte gluErrorString).

Comentários

A função gluScaleImage dimensiona uma imagem de pixel usando os modos de armazenamento de pixel apropriados para desempacotar dados da imagem de origem e empacotar dados na imagem de destino.

Ao reduzir uma imagem, gluScaleImage usa um filtro de caixa para amostrar a imagem de origem e criar pixels para a imagem de destino. Ao ampliar uma imagem, os pixels da imagem de origem são interpolados linearmente para criar a imagem de destino.

Para obter uma descrição dos valores aceitáveis para os parâmetros format, typein e typeout , consulte glReadPixels.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Glu.h
Biblioteca	Glu32.lib
DLL	Glu32.dll

Confira também

glDrawPixels

glReadPixels

gluBuild1DMipmaps

gluBuild2DMipmaps

gluErrorString