glCompileShader

Aus DGL Wiki
Version vom 30. April 2005, 11:20 Uhr von Flo (Diskussion | Beiträge) (glCompileShaderARB: ARB entfern der Kategorie SHADER_OBJECTS zugeordnet)

Wechseln zu: Navigation, Suche

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.)