glRasterPos2fv-Funktion
Gibt die Rasterposition für Pixeloperationen an.
Syntax
void WINAPI glRasterPos2fv(
const GLfloat *v
);
Parameter
-
V
-
Ein Zeiger auf ein Array von zwei Elementen, das x- und y-Koordinaten für die aktuelle Rasterposition an gibt.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Hinweise
OpenGL behält eine 3D-Position in Fensterkoordinaten bei. Diese Position, die als Rasterposition bezeichnet wird, wird mit Subpixelgenauigkeit beibehalten. Er wird verwendet, um Pixel- und Bitmap-Schreibvorgänge zu positionieren. Siehe glBitmap, glDrawPixelsund glCopyPixels.
Die aktuelle Rasterposition besteht aus drei Fensterkoordinaten (x, y, z), einem Clipkoordinatenwert w, einem Augenkoordinatenabstand, einem gültigen Bit und zugeordneten Farbdaten und Texturkoordinaten. Die w-Koordinate ist eine Clipkoordinate, da w nicht auf Fensterkoordinaten projiziert wird. Die glRasterPos4-Funktion gibt explizit die Objektkoordinaten x, y, z und w an. Die glRasterPos3-Funktion gibt die Objektkoordinaten x, y und z explizit an, während w implizit auf 1 festgelegt ist. Die glRasterPos2-Funktion verwendet die Argumentwerte für x und y, während z und w implizit auf 0 und 1 gesetzt werden.
Die von glRasterPos dargestellten Objektkoordinaten werden genau wie die eines glVertex-Befehls behandelt. Sie werden durch die aktuellen Modellansichts- und Projektionsmatrizen transformiert und an die Ausschneidephase übergeben. Wenn der Scheitelpunkt nicht gecullt wird, wird er projiziert und auf Fensterkoordinaten skaliert, die zur neuen aktuellen Rasterposition werden, und das FLAG GL CURRENT RASTER POSITION VALID wird _ _ _ _ festgelegt. Wenn der Scheitelpunkt gecullt wird, wird das gültige Bit gefiltert, und die aktuelle Rasterposition und die zugehörigen Farb- und Texturkoordinaten sind nicht definiert.
Die aktuelle Rasterposition enthält auch einige zugeordnete Farbdaten und Texturkoordinaten. Wenn die Beleuchtung aktiviert ist, wird GL CURRENT RASTER COLOR, im RGBA-Modus oder gl CURRENT RASTER INDEX im Farbindexmodus auf die Farbe festgelegt, die von der Beleuchtungsberechnung erzeugt wird _ _ _ _ _ _ (siehe glLight, glLightModelund glShadeModel). Wenn die Beleuchtung deaktiviert ist, wird die aktuelle Farbe (im RGBA-Modus, Die Zustandsvariable GL CURRENT COLOR) oder der Farbindex (im Farbindexmodus, Zustandsvariable _ GL CURRENT INDEX) verwendet, um die aktuelle Rasterfarbe zu _ _ _ aktualisieren.
Ebenso wird GL CURRENT RASTER TEXTURE COORDS als Funktion von GL CURRENT TEXTURE COORDS aktualisiert, basierend auf der Texturmatrix und den _ _ Texturgenerierungsfunktionen _ _ _ _ _ (siehe glTexGen). Schließlich ersetzt der Abstand vom Ursprung des Augenkoordinatensystems zum Scheitelpunkt, der nur von der Modellansichtsmatrix transformiert wird, GL _ CURRENT _ RASTER _ DISTANCE.
Anfänglich ist die aktuelle Rasterposition (0,0,0,1), der aktuelle Rasterabstand ist 0, das gültige Bit wird festgelegt, die zugeordnete RGBA-Farbe ist (1,1,1,1), der zugeordnete Farbindex ist 1 und die zugeordneten Texturkoordinaten sind (0, 0, 0, 1). Im RGBA-Modus ist GL CURRENT RASTER INDEX immer 1. Im Farbindexmodus behält die aktuelle _ _ RGBA-Rasterfarbe immer ihren _ Anfangswert bei.
Hinweis
Die Rasterposition wird sowohl durch glRasterPos als auch durch glBitmap geändert.
Hinweis
Wenn die Rasterpositionskoordinaten ungültig sind, werden Zeichnungsbefehle, die auf der Rasterposition basieren, ignoriert (d. h., sie führen nicht zu Änderungen am OpenGL-Zustand).
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glRasterPos ab:
glGet mit Argument GL _ CURRENT RASTER _ _ POSITION
glGet mit Argument GL _ CURRENT RASTER POSITION _ _ _ VALID
glGet mit dem Argument GL _ CURRENT RASTER _ _ DISTANCE
glGet mit argument GL _ CURRENT RASTER _ _ COLOR
glGet mit argument GL _ CURRENT _ RASTER _ INDEX
glGet mit argument GL _ CURRENT RASTER TEXTURE _ _ _ COORDS
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 |
|