glCompileShader
Inhaltsverzeichnis
glCompileShader (glCompileShaderARB)
Name
glCompileShader - Kompiliert ein Shaderobjekt.
Delphi-Spezifikation
function glCompileShader(shaderObj : GLHandle) : glboolean; function glCompileShaderARB(shaderObj : GLHandleARB) : glboolean;
Parameter
shaderObj | Handle des zu kompilierenden Shaderobjektes. |
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 glGetObjectParameter 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.
glGetObjectParameter mit den Argumenten shaderObj und GL_OBJECT_COMPILE_STATUS.
Siehe auch
glCreateShaderObject, glLinkProgram, glShaderSource
Hintergrundwissen : Shader
Englische Originalversion (Copyright 3DLabs Inc.)