glDepthFunc-Funktion

Die glDepthFunc-Funktion gibt den Wert an, der für Tiefenpuffervergleiche verwendet wird.

Syntax

void WINAPI glDepthFunc(
   GLenum func
);

Parameter

func

Gibt die Tiefenvergleichsfunktion an. Die folgenden symbolischen Konstanten werden akzeptiert.

Wert	Bedeutung
GL_NEVER	Niemals bestanden.
GL_LESS	Wird übergeben, wenn der eingehende z-Wert kleiner als der gespeicherte z-Wert ist. Dies ist der Standardwert.
GL_LEQUAL	Wird übergeben, wenn der eingehende z-Wert kleiner oder gleich dem gespeicherten z-Wert ist.
GL_EQUAL	Wird übergeben, wenn der eingehende z-Wert gleich dem gespeicherten z-Wert ist.
GL_GREATER	Wird übergeben, wenn der eingehende z-Wert größer als der gespeicherte z-Wert ist.
GL_NOTEQUAL	Wird übergeben, wenn der eingehende z-Wert nicht gleich dem gespeicherten z-Wert ist.
GL_GEQUAL	Wird übergeben, wenn der eingehende z-Wert größer oder gleich dem gespeicherten z-Wert ist.
GL_ALWAYS	Immer erfolgreich.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name	Bedeutung
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glDepthFunc-Funktion gibt die Funktion an, die verwendet wird, um jeden eingehenden Pixel z-Wert mit dem im Tiefenpuffer vorhandenen z-Wert zu vergleichen. Der Vergleich wird nur durchgeführt, wenn die Tiefentests aktiviert sind. (Siehe glEnable mit dem Argument GL_DEPTH_TEST.)

Zunächst ist der Tiefentest deaktiviert.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glDepthFunc ab:

glGet mit argument GL_DEPTH_FUNC

glIsEnabled mit Argument GL_DEPTH_TEST

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

glDepthRange

glEnable

glEnd

glGet

glIsEnabled