fonction glBitmap

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 de pixels 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 la bitmap, les 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 la bitmap, les directions droite et haut étant les axes positifs.

xmove

Décalage x à ajouter à la position raster actuelle après le dessin de la bitmap.

ymove

Décalage y à ajouter à la position raster actuelle après le dessin de la bitmap.

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 la hauteur est négative.
GL_INVALID_OPERATION
La fonction a été appelée entre un appel à glBegin et l’appel à glEnd correspondant.

Notes

Une bitmap est une image binaire. Lorsqu’elle est dessinée, la bitmap est positionnée par rapport à la position raster actuelle, et les pixels framebuffer correspondant à 1 dans la bitmap sont écrits à l’aide de la couleur raster ou de l’index actuel. Les pixels de mémoire tampon d’image correspondant à des zéros dans la 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 largeur et 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 raster actuelle n’est pas valide, glBitmap est ignoré. Sinon, le coin inférieur gauche de l’image bitmap est positionné aux coordonnées de la fenêtre suivantes :

xw = xrx x ?

yw = y ry y?

Dans ces coordonnées, (xr , yr ) est la position raster et (x? , y? ) est l’origine bitmap. Des 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 de la coordonnée z raster actuelle, de l’index de couleur ou de couleur et des coordonnées de texture 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 textures, la buée 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 raster actuelle sont décalées par xmove et ymove. Aucune modification n’est apportée à la coordonnée z de la position raster actuelle, ni à la couleur raster, à l’index ou aux coordonnées de texture actuelles.

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

glGet avec argument GL_CURRENT_RASTER_POSITION

glGet avec argument GL_CURRENT_RASTER_COLOR

glGet avec argument GL_CURRENT_RASTER_INDEX

glGet avec argument GL_CURRENT_RASTER_TEXTURE_COORDS

glGet avec argument GL_CURRENT_RASTER_POSITION_VALID

Spécifications

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