Función glBitmap

La función glBitmap dibuja un mapa de bits.

Sintaxis

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

Parámetros

width

Ancho de píxel de la imagen de mapa de bits.

height

Alto de píxeles de la imagen de mapa de bits.

xorig

Ubicación x del origen en la imagen de mapa de bits. El origen se mide desde la esquina inferior izquierda del mapa de bits, con direcciones derecha y hacia arriba siendo los ejes positivos.

yorig

Ubicación y del origen en la imagen de mapa de bits. El origen se mide desde la esquina inferior izquierda del mapa de bits, con direcciones derecha y hacia arriba siendo los ejes positivos.

xmove

Desplazamiento x que se va a agregar a la posición del ráster actual después de dibujar el mapa de bits.

ymove

Desplazamiento y que se va a agregar a la posición del ráster actual después de dibujar el mapa de bits.

bitmap

Dirección de la imagen de mapa de bits.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_VALUE	width o height es negativo.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

Un mapa de bits es una imagen binaria. Cuando se dibuja, el mapa de bits se coloca en relación con la posición del ráster actual y los píxeles de búfer de marco correspondientes a 1s del mapa de bits se escriben con el color o índice del ráster actual. Los píxeles del búfer de fotogramas correspondientes a ceros del mapa de bits no se modifican.

La imagen de mapa de bits se interpreta como datos de imagen para la función glDrawPixels , con ancho y alto correspondientes a los argumentos width y height de esa función, y con el tipo establecido en GL_BITMAP y formato establecido en GL_COLOR_INDEX. Los modos especificados mediante glPixelStore afectan a la interpretación de los datos de imagen de mapa de bits; los modos que especifique con glPixelTransfer no.

Si la posición del ráster actual no es válida, se omite glBitmap . De lo contrario, la esquina inferior izquierda de la imagen de mapa de bits se coloca en las siguientes coordenadas de ventana:

x_w = x_rx?

y_w = y_ry?

En estas coordenadas, (x_r , y_r ) es la posición ráster y (x? , y? ) es el origen del mapa de bits. A continuación, los fragmentos se generan para cada píxel correspondiente a un 1 de la imagen de mapa de bits. Estos fragmentos se generan mediante las coordenadas z de la trama actual, el color o el índice de color y las coordenadas de textura de trama actuales. A continuación, se tratan como si hubieran sido generados por un punto, una línea o un polígono, incluida la asignación de texturas, el fogging y todas las operaciones por fragmento, como las pruebas alfa y de profundidad.

Una vez dibujado el mapa de bits, las coordenadas x e y de la posición ráster actual se desplazan por xmove e ymove. No se realiza ningún cambio en la coordenada z de la posición del ráster actual o en las coordenadas de color, índice o textura actuales del ráster.

Las siguientes funciones recuperan información relacionada con la función glBitmap :

glGet con GL_CURRENT_RASTER_POSITION de argumentos

glGet con GL_CURRENT_RASTER_COLOR de argumentos

glGet con GL_CURRENT_RASTER_INDEX de argumentos

glGet con GL_CURRENT_RASTER_TEXTURE_COORDS de argumentos

glGet con GL_CURRENT_RASTER_POSITION_VALID de argumentos

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos