glBitmap-Funktion
Die GlBitmap-Funktion zeichnet eine Bitmap.
Syntax
void WINAPI glBitmap(
GLSizei width,
GLSizei height,
GLfloat xorig,
GLfloat yorig,
GLfloat xmove,
GLfloat ymove,
const GLubyte *bitmap
);
Parameter
-
width
-
Die Pixelbreite des Bitmapbilds.
-
height
-
Die Pixelhöhe des Bitmapbilds.
-
xorig
-
Die x-Position des Ursprungs im Bitmapbild. Der Ursprung wird aus der unteren linken Ecke der Bitmap gemessen, wobei die positiven Achsen von rechts und oben sind.
-
Yorig
-
Die y-Position des Ursprungs im Bitmapbild. Der Ursprung wird aus der unteren linken Ecke der Bitmap gemessen, wobei die positiven Achsen von rechts und oben sind.
-
Xmove
-
Der x-Offset , der der aktuellen Rasterposition hinzugefügt werden soll, nachdem die Bitmap gezeichnet wurde.
-
ymove
-
Der y-Offset , der der aktuellen Rasterposition hinzugefügt werden soll, nachdem die Bitmap gezeichnet wurde.
-
Bitmap
-
Die Adresse des Bitmapbilds.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Breite oder Höhe ist negativ. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Eine Bitmap ist ein binäres Bild. Beim Zeichnen wird die Bitmap relativ zur aktuellen Rasterposition positioniert, und Framebufferpixel, die 1 in der Bitmap entsprechen, werden mithilfe der aktuellen Rasterfarbe oder des aktuellen Indexes geschrieben. Framepufferpixel, die Nullen in der Bitmap entsprechen, werden nicht geändert.
Das Bitmapbild wird wie Bilddaten für die glDrawPixels-Funktion interpretiert, wobei breite und höhe entspricht, die den Breiten- und Höhenargumenten dieser Funktion entspricht, und der Typ auf GL_BITMAP und Format festgelegt auf GL_COLOR_INDEX festgelegt ist. Modi, die Sie mit glPixelStore angeben, wirken sich auf die Interpretation von Bitmapbilddaten aus; Modi, die Sie mit glPixelTransfer angeben, sind nicht zulässig.
Wenn die aktuelle Rasterposition ungültig ist, wird glBitmap ignoriert. Andernfalls wird die untere linke Ecke des Bitmapbilds an den folgenden Fensterkoordinaten positioniert:
xwxrx = ?
ywyry = ?
In diesen Koordinaten (xr , yr) ist die Rasterposition und (x? , y? ) ist der Bitmap-Ursprung. Fragmente werden dann für jedes Pixel generiert, das einem 1 in der Bitmapbild entspricht. Diese Fragmente werden mit der aktuellen Raster-Z-Koordinate, Farbe oder Farbindex und aktuellen Rastertexturkoordinaten generiert. Sie werden dann genauso behandelt, als ob sie durch einen Punkt, eine Linie oder ein Polygon generiert wurden, einschließlich Texturzuordnung, Nebel und alle Pro-Fragment-Vorgänge wie Alpha- und Tiefentests.
Nachdem die Bitmap gezeichnet wurde, werden die x - und y-Koordinaten der aktuellen Rasterposition durch xmove und ymove versetzt. Es wird keine Änderung an der Z-Koordinate der aktuellen Rasterposition oder an die aktuelle Rasterfarbe, index oder Texturkoordinaten vorgenommen.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit der glBitmap-Funktion ab:
glGet mit Argument GL_CURRENT_RASTER_POSITION
glGet mit Argument GL_CURRENT_RASTER_COLOR
glGet mit Argument GL_CURRENT_RASTER_INDEX
glGet mit Argument GL_CURRENT_RASTER_TEXTURE_COORDS
glGet mit Argument GL_CURRENT_RASTER_POSITION_VALID
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|