glRasterPos

glRasterPos

Name

glRasterPos - Legt die Rasterposition für Pixel-Operationen fest.

Delphi-Spezifikation

procedure glRasterPos2d (x: TGLdouble; y: TGLdouble);
procedure glRasterPos2f (x: TGLfloat; y: TGLfloat);
procedure glRasterPos2i (x: TGLint; y: TGLint);
procedure glRasterPos2s (x: TGLshort; y: TGLshort);
procedure glRasterPos3d (x: TGLdouble; y: TGLdouble; z: TGLdouble);
procedure glRasterPos3f (x: TGLfloat; y: TGLfloat; z: TGLfloat);
procedure glRasterPos3i (x: TGLint; y: TGLint; z: TGLint);
procedure glRasterPos3s (x: TGLshort; y: TGLshort; z: TGLshort);
procedure glRasterPos4d (x: TGLdouble; y: TGLdouble; z: TGLdouble; w: TGLdouble);
procedure glRasterPos4f (x: TGLfloat; y: TGLfloat; z: TGLfloat; w: TGLfloat);
procedure glRasterPos4i (x: TGLint; y: TGLint; z: TGLint; w: TGLint);
procedure glRasterPos4s (x: TGLshort; y: TGLshort; z: TGLshort; w: TGLshort);

Parameter

x	X-Wert der neuen Rasterposition
y	Y-Wert der neuen Rasterposition
z	Z-Wert der neuen Rasterposition; Standardwert ist 0.
w	W-Wert der neuen Rasterposition; Standardwert ist 1.

Delphi-Spezifikation

procedure glRasterPos2dv(const v: PGLdouble);
procedure glRasterPos2fv(const v: PGLfloat);
procedure glRasterPos2iv(const v: PGLint);
procedure glRasterPos2sv(const v: PGLshort);
procedure glRasterPos3dv(const v: PGLdouble);
procedure glRasterPos3fv(const v: PGLfloat);
procedure glRasterPos3iv(const v: PGLint);
procedure glRasterPos3sv(const v: PGLshort);
procedure glRasterPos4dv(const v: PGLdouble);
procedure glRasterPos4fv(const v: PGLfloat);
procedure glRasterPos4iv(const v: PGLint);
procedure glRasterPos4sv(const v: PGLshort);

Parameter

v	Ein Zeiger auf 2,3 oder 4 Elemente je nach Funktions Typ

Beschreibung

Die GL speichert eine 3D-Position in Fenstekoordinaten ab. Diese Position wird Rasterposition genannt. Sie wird zur Positionierung von Pixel- und Bitmap-Schreibvorgängen genutzt. Diese werden mit absoluter Pixel-Genauigkeit durchgeführt. Siehe glBitmap, glDrawPixels, und glCopyPixels.

Die aktuelle Rasterposition besteht aus den drei Fensterkoordinaten (X, Y, Z), der Clip-Koordinate W, den Auge-Koordinaten Abstand, einem Gültigkeits-Bit, sowie zugewieser Farbwerte und Texturkoordinaten. Die W-Koordinate ist eine Clip-Koordinate, da sie nicht erst in Fensterkoordinaten umgerechnet wird. Falls ein Funktionsaufruf Z oder W nicht beinhaltet, werden diese auf ihre Standardwerte(Z=0; W=1) gesetzt.

Die an glRasterPos übergebe Position wird so behandelt, als ob sie ein von glVertex erzeugter Punkt ist. Das heißt, dass auf sie die Projektions- und Model-View-Matrix angewandt und zurechtgeschnitten(en :"passed to the clipping stage") wird. Falls der resultierende Punkt nicht weggeschnitten wurde, wird der Punkt auf die Fenstergröße angepasst, als neue Rasterposition übernommen und das Gültigkeits-Flag GL_CURRENT_RASTER_POSITION_VALID gesetzt. Falls der Punkt weggeschnitten würde, wird das Flag geleert und die aktuelle Rasterposition inklusive Farbe und Texturkoordinaten ist undefiniert.

Die aktuelle Rasterposition erhält ebenso einen Farbwert und Texturkoordinaten. Falls die Beleuchtung aktiviert wurde, wird GL_CURRENT_RASTER_COLOR (im RGBA-Farbmodus) oder GL_CURRENT_RASTER_INDEX (im Farb-Index-Modus) auf die Farbe gesetz, die durch die Lichtberechnungen ermittelt wird. (Siehe glLight, glLightModel und glShadeModel.)

Ist die Beleuchtung deaktivert, so wird die aktuelle Farbe (im RGBA-Farbmodus die Statusvariable GL_CURRENT_COLOR) oder der Farben-Index (im Farben-Index-Modus die Statusvariable GL_CURRENT_INDEX) genutzt, um die neue Raster-Farbe zu bestimmen.

GL_CURRENT_RASTER_TEXTURE_COORDS wird so wie eine Funktion von GL_CURRENT_TEXTURE_COORDS, basierend auf der Texturmatrix und den Textur-Generationsfunktionen aktualisiert. Letztendlich ersetzt die Distanz zwischen Ursprung der Betrachterkoordinaten und dem durch die Model-View-Matrix transformierten Eckpunktes die GL_CURRENT_RASTER_DISTANCE.

Die Initialwerte der aktuellen Rasterposition sind (X:0; Y:0; Z:0; W:1), der Abstand ist 0, die Farbe ist weiß (1, 1, 1, 1), der Farb-Index ist 1 und die Textur Koordinaten sind (0, 0, 0, 1). Das Gültigkeits-Flag ist gesetzt.

Im RGBA-Farbmodus ist GL_CURRENT_RASTER_INDEX immer 1, im Farben-Index-Modus hingegen enthält die RGBA-Farbe ihren Startwert.

Hinweise

Die aktuelle Rasterposition kann nicht nur durch glRasterPos gesetzt, sondern auch durch glBitmap verschoben werden.

Wenn das Flag GL_CURRENT_RASTER_POSITION_VALID nicht gesetzt ist, also die aktuelle Rasterposition ungültig ist, werden sämtliche Zeichenbefehle ignoriert, die eine Rasterposition benötigen.

Ein Aufruf von glDrawElements hinterläßt eventuell eine nicht bestimmte Farbe bzw. Index. Wird glRasterPos aufgerufen, während die aktuelle Farbe bzw. der Index unbestimmt sind, so ist die aktuelle Rasterfarbe bzw. der Rasterindex undefiniert.

Durch einen Aufruf von glBitmap (mit dem Bild Parameter nil) ist es möglich, die Rasterposition auch außerhalb des sichtbaren Bereichs zu positionieren.

Fehlermeldungen

GL_INVALID_OPERATION wird generiert, wenn glRasterPos innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Zugehörige Wertrückgaben

glGet mit Token GL_CURRENT_RASTER_POSITION
glGet mit Token GL_CURRENT_RASTER_POSITION_VALID
glGet mit Token GL_CURRENT_RASTER_DISTANCE
glGet mit Token GL_CURRENT_RASTER_COLOR
glGet mit Token GL_CURRENT_RASTER_INDEX
glGet mit Token GL_CURRENT_RASTER_TEXTURE_COORDS

Siehe auch

glBitmap, glCopyPixels, glDrawElements, glDrawPixels, glWindowPos, glLight, glLightModel, glShadeModel, glTexCoord, glTexGen, glVertex