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 en pixels de l’image bitmap.

height

Hauteur en 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, avec des directions vers la droite et vers le 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, avec des directions vers la droite et vers le haut étant les axes positifs.

xmove

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

ymove

Décalage y à ajouter à la position de la trame 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 .

Name Signification
_valeur non valide du GL _
la largeur ou la hauteur est négative.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Remarques

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

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

Si la position raster actuelle n’est pas valide, glBitmap est ignoré. Dans le cas contraire, l’angle inférieur gauche de l’image bitmap est positionné aux coordonnées de la fenêtre suivante :

xw = xr x?

yw = or y?

Dans ces coordonnées, (xr , yr ) est la position raster et (x? , y? ) est l’origine de l’image 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 de la coordonnée z de trame 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 à l’aide d’un point, d’une ligne ou d’un polygone, y compris le mappage de texture, le surlignage et toutes les opérations par fragment, telles que le test alpha et de profondeur.

Une fois que l’image bitmap a été 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 du raster actuel ou aux coordonnées de couleur, d’index ou de texture raster actuelles.

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

glGet avec argument GL _ Current _ Raster _ position

glGet avec argument GL _ Current _ Raster _ couleur

glGet avec argument GL _ Current _ Raster _ index

glGet avec argument de _ la _ texture de TRAMe actuelle du _ GL _

glGet avec argument GL _ Current _ Raster _ position _ valide

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