fonction glBitmap
La fonction glBitmap dessine une bitmap.
void WINAPI glBitmap(
GLSizei width,
GLSizei height,
GLfloat xorig,
GLfloat yorig,
GLfloat xmove,
GLfloat ymove,
const GLubyte *bitmap
);
-
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.
Cette fonction ne retourne pas de valeur.
Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .
Nom | Signification |
---|---|
|
la largeur ou la hauteur est négative. |
|
La fonction a été appelée entre un appel à glBegin et l’appel à glEnd correspondant. |
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
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 |
|