glBitmap, fonction

La fonction glBitmap dessine une bitmap.

Syntaxe

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

Paramètres

width

Largeur du pixel de l’image bitmap.

height

Hauteur de pixels de l’image bitmap.

xorig

Emplacement x de l’origine dans l’image bitmap. L’origine est mesurée à partir du coin inférieur gauche de l’image bitmap, avec des directions droite et haut étant les axes positifs.

yorig

Emplacement y de l’origine dans l’image bitmap. L’origine est mesurée à partir du coin inférieur gauche de l’image bitmap, avec des directions droite et haut étant les axes positifs.

xmove

Décalage x à ajouter à la position de raster actuelle une fois l’image bitmap dessinée.

ymove

Décalage y à ajouter à la position de raster actuelle une fois la bitmap dessinée.

bitmap

Adresse de l’image bitmap.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom Signification
GL_INVALID_VALUE
la largeur ou lahauteur est négative.
GL_INVALID_OPERATION
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

Une bitmap est une image binaire. Quand elle est dessinée, la bitmap est positionnée par rapport à la position de raster actuelle et les pixels framebuffer correspondant à 1 dans la bitmap sont écrits à l’aide de la couleur ou de l’index raster actuel. Les pixels de mémoire tampon d’images correspondant aux zéros de l’image bitmap ne sont pas modifiés.

L’image bitmap est interprétée comme des données d’image pour la fonction glDrawPixels , avec la largeur et la hauteur correspondant aux arguments de largeur et de hauteur de cette fonction, et avec le type défini sur GL_BITMAP et le format défini sur GL_COLOR_INDEX. Les modes que vous spécifiez à l’aide de glPixelStore affectent l’interprétation des données d’image bitmap ; les modes que vous spécifiez à l’aide de glPixelTransfer ne le font pas.

Si la position de raster actuelle n’est pas valide, glBitmap est ignorée. Sinon, le coin inférieur gauche de l’image bitmap est positionné sur les coordonnées de la fenêtre suivante :

xwxrx = ?

ywyry = ?

Dans ces coordonnées, (xr, yr) est la position raster et (x? , y? ) est l’origine bitmap. Les fragments sont ensuite générés pour chaque pixel correspondant à un 1 dans l’image bitmap. Ces fragments sont générés à l’aide des coordonnées z de raster actuelles, de couleur ou d’index de couleur et des coordonnées de texture de raster actuelles. Ils sont ensuite traités comme s’ils avaient été générés par un point, une ligne ou un polygone, y compris le mappage de texture, la fogging et toutes les opérations par fragment, telles que les tests alpha et de profondeur.

Une fois la bitmap dessinée, les coordonnées x et y de la position de raster actuelle sont décalées par xmove et ymove. Aucune modification n’est apportée à la coordonnée z de la position de raster actuelle ou à la couleur, l’index ou les coordonnées de texture actuelles.

Les fonctions suivantes récupèrent des informations liées à la fonction glBitmap :

glGet avec l’argument GL_CURRENT_RASTER_POSITION

glGet avec l’argument GL_CURRENT_RASTER_COLOR

glGet avec l’argument GL_CURRENT_RASTER_INDEX

glGet avec l’argument GL_CURRENT_RASTER_TEXTURE_COORDS

glGet avec l’argument GL_CURRENT_RASTER_POSITION_VALID

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Gl.h
Bibliothèque
Opengl32.lib
DLL
Opengl32.dll

Voir aussi

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos