Função glBitmap

A função glBitmap desenha um bitmap.

Sintaxe

void WINAPI glBitmap(
         GLSizei width,
         GLSizei height,
         GLfloat xorig,
         GLfloat yorig,
         GLfloat xmove,
         GLfloat ymove,
   const GLubyte *bitmap
);

Parâmetros

width

A largura do pixel da imagem de bitmap.

altura

A altura do pixel da imagem de bitmap.

xorig

O local x da origem na imagem de bitmap. A origem é medida do canto inferior esquerdo do bitmap, com as direções direita e superior sendo os eixos positivos.

yorig

O local y da origem na imagem de bitmap. A origem é medida do canto inferior esquerdo do bitmap, com as direções direita e superior sendo os eixos positivos.

xmove

O deslocamento x a ser adicionado à posição de varredura atual depois que o bitmap é desenhado.

ymove

O deslocamento y a ser adicionado à posição de varredura atual depois que o bitmap é desenhado.

bitmap

O endereço da imagem de bitmap.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome	Significado
GL_INVALID_VALUE	width ou height é negativo.
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

Um bitmap é uma imagem binária. Quando desenhado, o bitmap é posicionado em relação à posição atual do raster e pixels de framebuffer correspondentes a 1s no bitmap são gravados usando a cor de varredura ou o índice atual. Pixels de buffer de quadro correspondentes a zeros no bitmap não são modificados.

A imagem de bitmap é interpretada como dados de imagem para a função glDrawPixels , com largura e altura correspondentes aos argumentos de largura e altura dessa função e com tipo definido como GL_BITMAP e formato definido como GL_COLOR_INDEX. Os modos especificados usando glPixelStore afetam a interpretação dos dados de imagem de bitmap; os modos que você especificar usando glPixelTransfer não.

Se a posição de varredura atual for inválida, glBitmap será ignorado. Caso contrário, o canto inferior esquerdo da imagem de bitmap será posicionado nas seguintes coordenadas da janela:

x_w = x_rx?

y_w = y_ry?

Nessas coordenadas, (x_r , y_r ) é a posição de varredura e (x? , y? ) é a origem do bitmap. Os fragmentos são gerados para cada pixel correspondente a um 1 na imagem de bitmap. Esses fragmentos são gerados usando a coordenada z de varredura atual, a cor ou o índice de cores e as coordenadas de textura de varredura atuais. Eles são tratados como se tivessem sido gerados por um ponto, linha ou polígono, incluindo mapeamento de textura, embaçamento e todas as operações por fragmento, como testes alfa e de profundidade.

Depois que o bitmap tiver sido desenhado, as coordenadas x e y da posição de varredura atual serão deslocadas por xmove e ymove. Nenhuma alteração é feita na coordenada z da posição do raster atual ou nas coordenadas de cor, índice ou textura do raster atual.

As seguintes funções recuperam informações relacionadas à função glBitmap :

glGet com GL_CURRENT_RASTER_POSITION de argumento

glGet com GL_CURRENT_RASTER_COLOR de argumento

glGet com GL_CURRENT_RASTER_INDEX de argumento

glGet com GL_CURRENT_RASTER_TEXTURE_COORDS de argumento

glGet com GL_CURRENT_RASTER_POSITION_VALID de argumento

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	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos