glGetProgram

2011-01-14T21:14:15Z

S4uri3r:

= glGetProgram =

== Name ==
'''glGetProgramiv''' - Liefert Eigenschaften eines Programmobjekts.

== Delphi-Spezifikation ==

procedure '''glGetProgram'''(''program'': TGLuint; ''pname'': TGLenum; ''params'': PGLint);

== Parameter ==

{| border="1" rules="all"
! ''program''
| Bestimmt das Programmobjekt dessen Daten ermittelt werden sollen.
|-
! ''pname''
| Bestimmt was abgefragt werden soll. Akzeptierte symbolische Namen sind '''GL_ACTIVE_ATTRIBUTE_MAX_LENGTH, GL_ACTIVE_ATTRIBUTES, GL_ACTIVE_UNIFORM_MAX_LENGTH, GL_ACTIVE_UNIFORMS, GL_ATTACHED_SHADERS, GL_DELETE_STATUS, GL_INFO_LOG_LENGTH, GL_LINK_STATUS, GL_VALIDATE_STATUS''' und mit der Extension [[GL_ARB_geometry_shader4]] weiterhin die symbolischen Namen '''GL_GEOMETRY_INPUT_TYPE_ARB, GL_GEOMETRY_OUTPUT_TYPE_ARB''' und '''GL_GEOMETRY_VERTICES_OUT_ARB'''.
|-
! ''params''
| Enthält das Ergebnis der Anfrage.
|}

== Beschreibung ==
'''glGetProgram''' liefert in ''params'' den Wert einer Eigenschaft eines bestimmten Programmobjekts. Die folgenden Werte für ''pname'' sind definiert:

=== GL_ACTIVE_ATTRIBUTE_MAX_LENGTH ===

:''params'' liefert die Länge des längsten aktiven Attributnamen für ''program'' inklusive des 0/Terminierungszeichens (Das entspricht der benötigten Größe des Zeichenpuffers um den längsten Attributnamen zu speichern). Falls kein aktives Attribut existiert wird 0 zurück geliefert.

=== GL_ACTIVE_ATTRIBUTES ===

:''params'' liefert die Anzahl der aktiven Attributvariablen für ''program''.

=== GL_ACTIVE_UNIFORM_MAX_LENGTH ===

:''params'' liefert die länge des längsten Namens einer aktiven Uniformvariable für ''program'' inklusive des 0/Terminierungszeichens (Das entspricht der benötigten Größe des Zeichenpuffers um den längsten Namen zu speichern). Falls keine aktive Uniformvariable existiert wird 0 zurück geliefert.

=== GL_ACTIVE_UNIFORMS ===

:''params'' liefert die Anzahl aktiver Uniformvariablen für ''program''.

=== GL_ATTACHED_SHADERS ===

:''params'' liefert die Anzahl der Shader-Objekte die an ''program'' gebunden sind.

=== GL_DELETE_STATUS ===

:''params'' liefert GL_TRUE falls ''program'' zum freigeben markiert wurde, sonst '''GL_FALSE'''.

=== GL_GEOMETRY_INPUT_TYPE_ARB ===
:''params'' liefert den zuletzt mit [[glProgramParameterARB]] gesetzten Typ der Input-Primitiven für [[Geometry Shader]]. Mögliche Rückgabewerte sind '''GL_POINTS ''', '''GL_LINES''', '''GL_LINES_ADJACENCY_ARB''', '''GL_TRIANGLES''' und '''GL_TRIANGLES_ADJACENCY_ARB'''. Steht nur im Zusammenhang mit der Extension [[GL_ARB_geometry_shader4]] zur Verfügung.

=== GL_GEOMETRY_OUTPUT_TYPE_ARB ===
:''params'' liefert den zuletzt mit [[glProgramParameterARB]] gesetzten Typ der Output-Primitiven für [[Geometry Shader]]. Mögliche Rückgabewerte sind '''GL_POINTS''', '''GL_LINE_STRIP''' und '''GL_TRIANGLE_STRIP'''. Steht nur im Zusammenhang mit der Extension [[GL_ARB_geometry_shader4]] zur Verfügung.

=== GL_GEOMETRY_VERTICES_OUT_ARB ===
:''params'' liefert die zuletzt mit [[glProgramParameterARB]] gesetzte maximale Anzahl von Output-Vertices für [[Geometry Shader]]. Steht nur im Zusammenhang mit der Extension [[GL_ARB_geometry_shader4]] zur Verfügung.

=== GL_INFO_LOG_LENGTH ===

:''params'' liefert die Anzahl der Zeichen im InfoLog von ''program'' einschließlich des 0/Terminierungszeichens (Dies entspricht der Größe des Zeichenpuffers der benötigt wird um das InfoLog zu speichern). Falls ''program'' kein InfoLog hat, wird der Wert 0 zurück geliefert.

=== GL_LINK_STATUS ===

:''params'' liefert GL_TRUE falls die letzte Link-Operation auf ''program'' erfolgreich war, sonst '''GL_FALSE'''.

=== GL_VALIDATE_STATUS ===

:''params'' liefert GL_TRUE falls die letzte Validierungs-Operation auf ''program'' erfolgreich war, sonst '''GL_FALSE'''.

== Hinweise ==
'''glGetProgram''' ist erst ab OpenGL Version 2.0 oder höher verfügbar.

Falls ein Fehler auftritt werden keine Änderungen am Inhalt von ''params'' gemacht.

== Fehlermeldungen ==
'''GL_INVALID_ENUM''' wird generiert wenn ''pname'' kein akzeptierter Wert ist. 
'''GL_INVALID_VALUE''' wird generiert wenn ''program'' kein von OpenGL generierter Wert ist. 
'''GL_INVALID_OPERATION''' wird generiert wenn ''program'' kein Programmobjekt bezeichnet. 
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGetProgram''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.

== Zugehörige Wertrückgaben ==
[[glGetActiveAttrib]] mit dem Argument ''program''

[[glGetActiveUniform]] mit dem Argument ''program''

[[glGetAttachedShaders]] mit dem Argument ''program''

[[glGetProgramInfoLog]] mit dem Argument ''program''

[[glIsProgram]]

== Siehe auch ==
[[glAttachShader]], [[glCreateProgram]], [[glDeleteProgram]], [[glGetShader]], [[glLinkProgram]], [[glProgramParameterARB]], [[glValidateProgram]]

'''Hintergrundwissen :''' [[Shader]]

[[Kategorie:GL|GetProgram]]
[[Kategorie:GL2.0|GetProgram]]
[[Kategorie:SHADER_OBJECTS|GetProgram]]

glGetShaderInfoLog

2011-01-14T18:43:28Z

S4uri3r:

= glGetShaderInfoLog =

== Name ==
'''glGetShaderInfoLog''' - Gibt das Information-Log eines Shaderobjekts aus

 
== Delphi-Spezifikation ==

procedure '''glGetShaderInfoLog'''(''shader'' : GLuint; ''maxLength'' : GLsizei; ''length'' : PGLsizei; ''infoLog'' : PGLchar)

== Parameter ==

{| border="1" rules="all"
! ''shader''
| Gibt das Shaderobjekt an, dessen Information-Log abgefragt werden soll.
|-
! ''maxLength''
| Gibt die Größe des Zeichen-Puffers für das Speichern des erhaltenen Information-Logs an.
|-
! ''length''
| Gibt die Länge des Strings (ohne die Null-Terminierung) an, der nach ''infoLog'' ausgegeben wird.
|-
! ''infoLog''
| Gibt ein Zeichen-Array an, das verwendet wird, um das Information-Log auszugeben.
|}

== Beschreibung ==
'''glGetShaderInfoLog''' gibt das Information-Log für das spezifizierte Shaderobjekt aus. Das Information-Log eines Shaderobjekts wird verändert, wenn das Shaderobjekt gelinkt oder validiert wird. Der ausgegebene String ist null-terminiert.

'''glGetShaderInfoLog''' legt in ''infoLog'' maximal so viele Zeichen des Information-Log ab, wie durch ''maxLength'' angegeben wurde. Die Anzahl der ausgegebenen Zeichen - ausschließlich der Null-Terminierung - wird durch ''length'' angegeben. Wenn die Länge des ausgegenen Strings nicht von Interesse ist, kann '''nil''' als ''length''-Argument verwendet werden. Die Größe des Puffers, der zum Speichern des zurückgelieferten Information-Log verwendet wird, kann durch einen Aufruf von [[glGetShader]] mit dem Argument '''GL_INFO_LOG_LENGTH''', herausgefunden werden.

Das Information-Log für ein Shaderobjekt ist entweder ein leerer String oder ein String, der Informationen über die letzte Link- oder Validierungs-Operation enthält. Das Log kann Diagnose-Nachrichten, Warnungen und andere Informationen enthalten. Wenn ein Shaderobjekt erzeugt wird, ist sein Informations-Log nicht unbedingt ein String mit der Länge 0, beispielsweise können gewisse OpenGL-Implementationen die Ausgabe "no errors." mit length 11 ausgeben. Deshalb sollte man vor einem Aufruf von '''glGetShaderInfoLog''' [[glGetShader]] mit dem Argument '''GL_COMPILE_STATUS''' abfragen.

 

== Hinweise ==
'''glGetShaderInfoLog''' ist nur in OpenGL-Versionen ab mindestens 2.0 verfügbar.

Das Information-Log für ein Shaderobjekt ist der wichtigste Weg der OpenGL-Implementation, Informationen über das Linken und Validieren mitzuteilen. Das Information-Log kann während dem Entwicklungsprozess hilfreich für Programmierer sein, auch wenn diese Operationen erfolgreich verlaufen. Man sollte aber nicht erwarten, dass verschiedene OpenGL-Implementationen (vor allem von verschiedenen Herstellern) identische Information-Logs liefern.

== Fehlermeldungen ==
'''GL_INVALID_VALUE''' wird generiert, wenn ''shader'' kein von OpenGL erzeugter Wert ist.

'''GL_INVALID_OPERATION''' wird generiert, wenn ''shader'' kein Shaderobjekt ist.

'''GL_INVALID_VALUE''' wird generiert, wenn ''maxLength'' kleiner 0 ist.

'''GL_INVALID_OPERATION''' wird generiert, wenn '''glGetShaderInfoLog''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.

== Zugehörige Wertrückgaben ==
[[glGetShader]] mit Token [[glGetShader#GL_INFO_LOG_LENGTH|GL_INFO_LOG_LENGTH]]

[[glIsShader]]

== Siehe auch ==
[[glCompileShader]], [[glGetShaderInfoLog]], [[glLinkProgram]], [[glValidateProgram]]

[[Kategorie:GL|GetProgram]]

DGL Wiki - Benutzerbeiträge [de]

glGetProgram

glGetShaderInfoLog