funzione glBitmap

Articolo
06/13/2023

La funzione glBitmap disegna una bitmap.

Sintassi

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

Parametri

width: Larghezza in pixel dell'immagine bitmap.
height: Altezza in pixel dell'immagine bitmap.
xorig: Posizione x dell'origine nell'immagine bitmap. L'origine viene misurata dall'angolo inferiore sinistro della bitmap, con le direzioni destra e superiore che costituiscono gli assi positivi.
yorig: Posizione y dell'origine nell'immagine bitmap. L'origine viene misurata dall'angolo inferiore sinistro della bitmap, con le direzioni destra e superiore che costituiscono gli assi positivi.
xmove: Offset x da aggiungere alla posizione raster corrente dopo il disegno della bitmap.
ymove: Offset y da aggiungere alla posizione raster corrente dopo il disegno della bitmap.
bitmap: Indirizzo dell'immagine bitmap.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome	Significato
GL_INVALID_VALUE	larghezza o altezza è negativa.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

Una bitmap è un'immagine binaria. Quando viene disegnato, la bitmap viene posizionata rispetto alla posizione raster corrente e i pixel framebuffer corrispondenti a 1 nella bitmap vengono scritti usando il colore raster o l'indice corrente. I pixel del buffer di frame corrispondenti agli zeri nella bitmap non vengono modificati.

L'immagine bitmap viene interpretata come dati immagine per la funzione glDrawPixels, con larghezza e altezza corrispondenti agli argomenti di larghezza e altezza di tale funzione e con il tipo impostato su GL_BITMAP e formato impostato su GL_COLOR_INDEX. Le modalità specificate tramite glPixelStore influiscono sull'interpretazione dei dati delle immagini bitmap; le modalità specificate utilizzando glPixelTransfer non lo fanno.

Se la posizione raster corrente non è valida, glBitmap viene ignorato. In caso contrario, l'angolo inferiore sinistro dell'immagine bitmap viene posizionato alle coordinate della finestra seguenti:

x_w = x_xx?

y_w = y_ry?

In queste coordinate ( x_r , y_r ) è la posizione raster e (x? , y? ) è l'origine bitmap. I frammenti vengono quindi generati per ogni pixel corrispondente a un 1 nell'immagine bitmap. Questi frammenti vengono generati usando la coordinata z raster corrente, l'indice di colore o di colore e le coordinate correnti della trama raster. Vengono quindi trattati come se fossero stati generati da un punto, una linea o un poligono, tra cui mapping delle trame, fogging e tutte le operazioni per frammento, ad esempio i test alfa e profondità.

Dopo aver disegnato la bitmap, le coordinate x e y della posizione raster corrente vengono sfalsate da xmove e ymove. Non viene apportata alcuna modifica alla coordinata z della posizione raster corrente o alle coordinate raster, indice o trama correnti.

Le funzioni seguenti recuperano informazioni correlate alla funzione glBitmap :

glGet con argomento GL_CURRENT_RASTER_POSITION

glGet con argomento GL_CURRENT_RASTER_COLOR

glGet con argomento GL_CURRENT_RASTER_INDEX

glGet con argomento GL_CURRENT_RASTER_TEXTURE_COORDS

glGet con argomento GL_CURRENT_RASTER_POSITION_VALID

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glBegin
glDrawPixels
glEnd
glPixelStore
glPixelTransfer
glRasterPos