Función glBitmap
La función glBitmap dibuja un mapa de bits.
void WINAPI glBitmap(
GLSizei width,
GLSizei height,
GLfloat xorig,
GLfloat yorig,
GLfloat xmove,
GLfloat ymove,
const GLubyte *bitmap
);
-
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.
Esta función no devuelve ningún valor.
La función glGetError puede recuperar los siguientes códigos de error.
Nombre | Significado |
---|---|
|
width o height es negativo. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
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:
xw = xrx?
yw = yry?
En estas coordenadas, (xr , yr ) 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
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 |
|
Biblioteca |
|
Archivo DLL |
|