Version vom 15. Juni 2011, 20:45 Uhr

glCompileShader (glCompileShaderARB)

Name

glCompileShader - Kompiliert ein Shaderobjekt.

Delphi-Spezifikation

procedure glCompileShader(shaderObj : GLHandle);
procedure glCompileShaderARB(shaderObj : GLHandleARB);

Parameter

Beschreibung

glCompileShader kompiliert den Quellcode der im Shaderobjekt abgelegt ist, wobei der Status der Kompilation als Teil des Objektstatus des Shaderobjektes gespeichert wird. Dieser Wert ist True, wenn der Shader ohne Fehler kompiliert wurde und bereit zur Nutzung ist, und ansonsten False. Er kann mittels glGetObjectParameterARB und dem Shader sowie GL_OBJECT_COMPILE_STATUS als Argument abgefragt werden.

Die Kompilierung des Shaders kann aus vielerlei Gründen scheitern, die genauer in den Spezifikationen der OpenGL-Shadersprache aufgelistet sind. Ob die Kompilierung erfolgreich war, kann aus dem Informationslog des Shaderobjektes via glGetInfoLogARB ermittelt werden.

Seit der OpenGL Version 2.0 ist glCompileShader im Kern enthalten. Die alte ARB Bezeichnung war glCompileShaderARB.

Fehlermeldungen

GL_INVALID_VALUE wird generiert, wenn der Shader kein gültiges OpenGL-Handle ist.

GL_INVALID_OPERATION wird generiert, wenn der Shader nicht vom Typ GL_SHADER_OBJECT ist.

GL_INVALID_OPERATION wird generiert, wenn glCompileShaderARB zwischen einem glBegin und dem passenden glEnd aufgerufen wird.

Zugehörige Wertrückgaben

glGetInfoLog mit dem Argument shaderObj.

glGetObjectParameterARB mit den Argumenten shaderObj und GL_OBJECT_COMPILE_STATUS.

Siehe auch

glCreateShaderObjectARB, glLinkProgram, glShaderSource
Hintergrundwissen : Shader

Englische Originalversion (Copyright 3DLabs Inc.)