glGetInfoLogARB: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
 
K (Bot: konvertiere/korrigiere <BR>)
 
(2 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= glGetInfoLogARB =
 
= glGetInfoLogARB =
  
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
 
'''glGetInfoLogARB''' - liefert geloggte Information eines Objekts
 
'''glGetInfoLogARB''' - liefert geloggte Information eines Objekts
  
<br>
+
 
 +
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
 
  procedure '''glGetInfoLogARB'''(''object'' : GLhandleARB; ''maxLength'' : GLsizei; ''length'' : ^GLsizei;<br> ''infoLog'' : ^GlcharARB)
 
  procedure '''glGetInfoLogARB'''(''object'' : GLhandleARB; ''maxLength'' : GLsizei; ''length'' : ^GLsizei;<br> ''infoLog'' : ^GlcharARB)
  
<br>
+
 
 +
 
  
 
== Parameter ==
 
== Parameter ==
Zeile 31: Zeile 34:
 
'''glGetInfoLogARB''' liefert geloggte Informationen für das angegebene - von OpenGL erzeugte - Objekt. Die Informationen über ein Shaderobjekt werden verändert, wenn der Shader kompiliert wird und die Informationen über Programmobjekt werden verändert, wenn das Programmobjekt gelinkt oder überprüft wurde. Der zurückgelieferte String ist unterminiert.<br>
 
'''glGetInfoLogARB''' liefert geloggte Informationen für das angegebene - von OpenGL erzeugte - Objekt. Die Informationen über ein Shaderobjekt werden verändert, wenn der Shader kompiliert wird und die Informationen über Programmobjekt werden verändert, wenn das Programmobjekt gelinkt oder überprüft wurde. Der zurückgelieferte String ist unterminiert.<br>
 
<br>
 
<br>
'''glGetInfoLogARB''' speichert in ''infoLog'' so viel wie möglich ab, die Obergrenze ist durch ''maxLength'' gegeben.
+
'''glGetInfoLogARB''' speichert in ''infoLog'' so viel wie möglich ab, die Obergrenze ist durch ''maxLength'' gegeben. Die wirkliche Anzahl der ausgebenen Zeichen wird in ''length''  ausgegeben. Wenn die Länge des zurückgelieferten Strings uninteressant ist, kann '''nil''' an das ''length''-Argument übergeben werden. Die Länge der geloggten Informationen kann man durch den Aufruf von [[glGetObjectParameterARB]] mit dem Token '''GL_OBJECT_INFO_LOG_LENGTH_ARB''' abfragen.<br>
 +
<br>
 +
Die geloggten Informationen können die Nachrichten zur Analyse, Warnungen und andere Mitteilungen über den letzten Kompilier-Vorgang (von Shaderobjekten) oder das letzte Linken oder Überprüfen (von Programmobjekten) enthalten. Wenn ein Shaderobjekt oder ein Programmobjekt erzeugt wird, ist die Länge des Logs 0.
 +
<br>
 +
== Hinweise ==
 +
Die geloggten Informationen sind sie einzige Möglichkeit, Nachrichten über das Kompilieren, Linken und Überprüfen abzufragen, so dass das Log nützlich für Programmierer sein kann, auch wenn das Kompilieren und Linken problemlos verlaufen ist. Programmierer sollten aber nicht erwarten, dass verschiedene OpenGL-Implementationen identische Informationen liefern. Logs von ATI und NVidia zum Beispiel unterscheiden sich sehr stark.
  
glGetInfoLogARB returns in infoLog as much of the information log as it can, up to a maximum of maxLength characters. The number of characters actually returned, excluding the null termination character, is specified by length . If the length of the returned string is not required, a value of NULL can be passed in the length argument. The actual length of the information log can be obtained by calling glGetObjectParameterARB with the value GL_OBJECT_INFO_LOG_LENGTH_ARB.
 
  
The information log is a string that may contain diagnostic messages, warning messages, and other information about the last compile operation (for shader objects) or the last link or validate operation (for program objects). When a shader object or a program object is created, its information log will be a string of length 0.
 
<br>
 
== Hinweise ==
 
Bitte beachten dass...
 
  
<br>
 
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
'''GL_FEHLER''' wird generiert wenn....<br>
+
'''GL_INVALID_VALUE''' wird generiert, wenn ''object'' kein von OpenGL erzeugtes Handle ist.<br>
'''GL_INVALID_OPERATION''' wird generiert wenn FUNCTIONNAME innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.  
+
'''GL_INVALID_OPERATION''' wird generiert, wenn ''object'' nicht vom Typ '''GL_PROGRAM_OBJECT_ARB''' oder '''GL_SHADER_OBJECT_ARB''' ist. <br>
 +
'''GL_INVALID_OPERATION''' wird generiert, wenn '''glGetInfoLogARB''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.  
 +
 
 +
 
  
<br>
 
  
 
==  Zugehörige Wertrückgaben ==
 
==  Zugehörige Wertrückgaben ==
[[glGet]] mit Token [[glGet#GL_MEIN_TOKEN|GL_MEIN_TOKEN]]
+
[[glGetObjectParameterARB]] mit Token [[glGetObjectParameterARB#GL_OBJECT_INFO_LOG_LENGTH_ARB|GL_OBJECT_INFO_LOG_LENGTH_ARB]]
 
 
 
<br>
 
<br>
  
 
== Siehe auch ==
 
== Siehe auch ==
Hier eine Liste (als Medialinks) von Befehlen die diesem ähnlich sind. Bitte alle Begriffe hintereinander und mit einem Komma voneinander trennen.
+
[[glCompileShaderARB]], [[glLinkProgramARB]], [[glValidateProgramARB]]  
 
 
Zum Abschluss noch an diese Stelle den Artikel einer Kategorie zuordnen. z.B.<br>
 
'''<nowiki>[[Kategorie:GL|FuncNameOhneGLamAnfang]]</nowiki>'''
 
  
----
+
[[Kategorie:GL|GetInfoLogARB]]
Um diese Vorlage direkt zu nutzen, bitte diese Seite bearbeiten und die Vorlage direkt rauskopieren!
 

Aktuelle Version vom 22. April 2006, 19:20 Uhr

glGetInfoLogARB

Name

glGetInfoLogARB - liefert geloggte Information eines Objekts


Delphi-Spezifikation

procedure glGetInfoLogARB(object : GLhandleARB; maxLength : GLsizei; length : ^GLsizei;
infoLog : ^GlcharARB)



Parameter

object Gibt das Handle des Objekts an, dessen Informationen abgerufen werden soll.
maxLength Gibt die Größe des Zeichen-Puffers an, in dem die Informationen abgelegt werden sollen.
length Liefert die Länge des Strings, der in infoLog abgelegt wurde.
infoLog Gibt ein Array mit Zeichen an, das verwendet wird, die geloggten Informationen zurückzugeben.


Beschreibung

glGetInfoLogARB liefert geloggte Informationen für das angegebene - von OpenGL erzeugte - Objekt. Die Informationen über ein Shaderobjekt werden verändert, wenn der Shader kompiliert wird und die Informationen über Programmobjekt werden verändert, wenn das Programmobjekt gelinkt oder überprüft wurde. Der zurückgelieferte String ist unterminiert.

glGetInfoLogARB speichert in infoLog so viel wie möglich ab, die Obergrenze ist durch maxLength gegeben. Die wirkliche Anzahl der ausgebenen Zeichen wird in length ausgegeben. Wenn die Länge des zurückgelieferten Strings uninteressant ist, kann nil an das length-Argument übergeben werden. Die Länge der geloggten Informationen kann man durch den Aufruf von glGetObjectParameterARB mit dem Token GL_OBJECT_INFO_LOG_LENGTH_ARB abfragen.

Die geloggten Informationen können die Nachrichten zur Analyse, Warnungen und andere Mitteilungen über den letzten Kompilier-Vorgang (von Shaderobjekten) oder das letzte Linken oder Überprüfen (von Programmobjekten) enthalten. Wenn ein Shaderobjekt oder ein Programmobjekt erzeugt wird, ist die Länge des Logs 0.

Hinweise

Die geloggten Informationen sind sie einzige Möglichkeit, Nachrichten über das Kompilieren, Linken und Überprüfen abzufragen, so dass das Log nützlich für Programmierer sein kann, auch wenn das Kompilieren und Linken problemlos verlaufen ist. Programmierer sollten aber nicht erwarten, dass verschiedene OpenGL-Implementationen identische Informationen liefern. Logs von ATI und NVidia zum Beispiel unterscheiden sich sehr stark.


Fehlermeldungen

GL_INVALID_VALUE wird generiert, wenn object kein von OpenGL erzeugtes Handle ist.
GL_INVALID_OPERATION wird generiert, wenn object nicht vom Typ GL_PROGRAM_OBJECT_ARB oder GL_SHADER_OBJECT_ARB ist.
GL_INVALID_OPERATION wird generiert, wenn glGetInfoLogARB innerhalb eines glBegin-glEnd Blocks aufgerufen wird.



Zugehörige Wertrückgaben

glGetObjectParameterARB mit Token GL_OBJECT_INFO_LOG_LENGTH_ARB

Siehe auch

glCompileShaderARB, glLinkProgramARB, glValidateProgramARB