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
GL_INVALID_VALUE
Breite oder Höhe ist negativ.
GL_INVALID_OPERATION
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Siehe auch

glBegin

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glRasterPos