glGetShaderSourceARB

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glGetShaderSourceARB


Name

glGetShaderSourceARB - Liefert den Quelltextstring eines Shaderobjekts


Delphi-Spezifikation

procedure glGetShaderSourceARB(shader : GLhandleARB; maxLength : GLsizei;
                               length : PGLsizei; source : PGLcharARB)


Parameter

shader Gibt das Shaderobjekt an, das abgefragt werden soll.
PmaxLength Gibt die Größe des Characterpuffers zur Speicherung des zurückgelieferten Quelltextstrings an.
length Liefert die Länge des Strings, der nach source ausgegeben wird.
source Liefert ein Array mit Zeichen, das zur Ausgabe des Quelltextstrings verwendet wird.


Beschreibung

glGetShaderSourceARB liefert den Quelltextstring des Shaders, der mit shader angegeben wurde. Der Quelltextstring eines Shaderobjekts ist das Ergebnis eines vorhergehenden Aufrufs von glShaderSourceARB. Der zurückgelieferte String ist Null-terminiert.

glGetShaderSourceARB gibt in source so viel aus, wie durch maxLength gestattet ist. Die Anzahl der Zeichen (ohne das Endezeichen/Null-Terminierung), die tatsächlich zurückgeliefert werden, wird mit length festgelegt. Wenn die Länge des zurückgeliegert Strings unerheblich ist, kann nil length-Argument übergeben werden. Die Länge des Quelltextstrings kann man durch einen Aufruf von glGetObjectParameterARB mit dem Token GL_OBJECT_SHADER_SOURCE_LENGTH_ARB erhalten.

Fehlermeldungen

GL_INVALID_VALUE wird generiert, wenn shader nicht ein von OpenGL erzeugtes Handle ist.

GL_INVALID_OPERATION wird generiert, wenn shader nicht vom Typ GL_SHADER_OBJECT_ARB ist.

GL_INVALID_OPERATION wird generiert wenn glGetShaderSourceARB innerhalb eines glBegin-glEnd Blocks aufgerufen wird.


Zugehörige Wertrückgaben

glGetObjectParameterARB mit Token GL_OBJECT_SHADER_SOURCE_LENGTH_ARB

Siehe auch

glCreateShaderObjectARB, glGetObjectParameterARB, glShaderSourceARB