fonction glBitmap

Article
06/13/2023

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 :

x_w = x_rx x ?

y_w = y ry y?

Dans ces coordonnées, (x_r , y_r ) 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