Condividi tramite


funzione glBitmap

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:

xw = xxx?

yw = yry?

In queste coordinate ( xr , yr ) è 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