Version vom 27. August 2008, 17:31 Uhr

glFrustum

Name

glFrustum - Multipliziert die aktuelle Matrix mit einer perspektivischen Matrix.

Delphi-Spezifikation

procedure glFrustum(left, right, bottom, top, zNear, zFar : glDouble);

Parameter

Bildliche Darstellung eines Frustums.

Beschreibung

glFrustum beschreibt eine perspektivische Matrix, die eine perspektivische Projektion herstellt. Die aktuelle Matrix (siehe glMatrixMode) wird mit dieser Matrix multipliziert, und dieses Ergebnis ersetzt die aktuelle Matrix, als ob glMultMatrix mit folgender Matrix aufgerufen worden wäre :

Es gilt:
f = zFar
n = zNear
l = left
r = right
t = top
b = bottom

Normalerweise ist der Matrizenmodus GL_PROJECTION, (Links, Unten, -Z-Nah) und (Rechts, Oben, -Z-Nah) beschreiben die Punkte auf der Nah-Schnittfläche, die auf die linkere untere, und obere rechte Ecke des Fensters gelegt werden, unter Annahme dass das Auge bei (0,0,0) liegt. - Z-Fern gibt dabei die Position der Fern-Schnittfläche an. Sowohl Z-Fern als auch Z-Nah müssen positiv sein.

Mittels glPushMatrix und glPopMatrix kann man Matrizen auf dem Stack sichern bzw. wieder zurücknehmen.

Hinweise

Die Genauigkeit des Tiefenpuffers hängt von den in Z-Nah und Z-Fern angegebenen Werte ab. Je größer der Ratio von Z-Fern zu Z-Nah ist, desto niedriger wird der Tiefenpuffer aufgelöst.

Wenn

r = Z-Nah / Z-Fern

dann gehen ~ log 2*r Bits an Tiefenpuffergenauigkeit verloren.
Z-Fern darf nicht Null sein, weil die Division durch 0 nicht definiert ist.
Z-Nah darf nicht Null sein, weil sonst r Null wird und dann ist log 2*r nicht definiert.

Fehlermeldungen

GL_INVALID_VALUE wird generiert, wenn zNear oder zFar null oder negativ ist, zNear gleich zFar, left gleich right oder top gleich bottom ist.

GL_INVALID_OPERATION wird generiert, wenn glFrustum zwischen einem glBegin und dem zugehörigen glEnd aufgerufen wird.

Zugehörige Wertrückgaben

glGet mit dem Token GL_MATRIX_MODE.
glGet mit dem Token GL_MODELVIEW_MATRIX.
glGet mit dem Token GL_PROJECTION_MATRIX.
glGet mit dem Token GL_TEXTURE_MATRIX.

Siehe auch

Hintergrund: Frustum

glOrtho, glMatrixMode, glMultMatrix, glPushMatrix, glViewport