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 |
|---|---|
|
la largeur ou la hauteur est négative. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|