glLinkProgram - Versionsgeschichte

DGLBot: Bot: konvertiere/korrigiere

2006-04-22T18:22:22Z

Bot: konvertiere/korrigiere

DGLBot: GlLinkProgram wurde nach glLinkProgram verschoben

2005-12-05T19:29:32Z

GlLinkProgram wurde nach glLinkProgram verschoben

Flo: /* Name */ -ARB

2005-06-28T19:37:28Z

‎Name: -ARB

134.109.201.50: /* Siehe auch */

2005-06-28T13:18:31Z

‎Siehe auch

134.109.201.50: Kategorie Zugeordnet

2005-06-28T13:18:15Z

Kategorie Zugeordnet

134.109.201.50: Fertig gemacht

2005-06-28T13:16:14Z

Fertig gemacht

134.109.201.50: /* Siehe auch */

2005-06-28T13:15:54Z

‎Siehe auch

2005-06-28T13:13:00Z

134.109.201.50: /* Delphi-Spezifikation */

2005-06-28T13:05:55Z

‎Delphi-Spezifikation

Flash am 23. Juni 2005 um 09:35 Uhr

2005-06-23T09:35:46Z

Neue Seite

{{Offline}}

= glLinkProgramARB =

 
== Name ==
'''glLinkProgramARB''' - linkt die momentan an ein Programmobjekt gebundenen Shader, um daraus einen Satz ausführbarer Shader zu erstellen.

 
== Delphi-Spezifikation ==
procedure '''glLinkProgramARB'''(''programObj'' GLhandleARB);

 
== Parameter ==
<table border=1 rules=all>
<tr>
<td>''programObj''</td>
<td>Handle des Programmobjektes das gelinkt werden soll.</td>
</tr>
</table>

 
== Beschreibung ==
'''glLinkProgram''' linkt die momentan an ''programObj'' gebundenen Shader, um daraus einen Satz ausführbarer Shader zu erstellen. Wenn Shaderobjekte vom Typ ''GL_VERTEX_SHADER'' an ''programObj'' angehangen sind, werden diese genutzt um einen ausführbaren Shader zu erstellen der auf dem programmierbaren '''Vertexprozessor''' abläuft. Sind Shaderobjekte vom Typ ''GL_FRAGMENT_SHADER'' an ''programObj'' angehangen, so werden diese genutzt um den ausführbaren Shader zu erstellen der auf dem programmierbaren '''Fragmentprozessor''' läuft.

Der Status des Linkvorgangs wird dabei als Teil des Objektstatus von ''programObj'' abgelegt, und ist '''GL_TRUE''', wenn das Programmobjekt ohne Fehler gelinkt wurde, bzw. GL_FALSE, wenn dies nicht der Fall war. Abgefragt kann dieser Status über den Befehl [[glGetProgram]] mit den Argumenten ''programObj'' und '''GL_LINK_STATUS''' werden.

Als Ergebnis eines erfolgreichen Linkvorganges, werden alle dem Programm zugehörigen (aktiven) Uniformvariablen auf 0 gesetzt und alle aktiven Uniformwerte des Programmobjektes werden an einen Platz, gebunden dessen Status mittels [[glGetUniformLocation]] angefragt werden kann. Weiterhin werden zu diesem Zeitpunkt alle nutzerdefinierten Attributvariablen die noch nicht an einen generischen Vertex-Attribut-Index gebunden wurden, an einen solchen gebunden.

Das Linken eines Programmobjektes kann aus einer Vielzahl von Gründen fehlschlagen, die in der Sprachdefinition zur OpenGL-Shadersprache erläutert werden. Dinge die einen Fehler beim Linken verursachen können :
<ul>
<li>Die Anzahl der von der Implementation zur Verfügung gestellten Attributvariablen wurde überschritten.</li>
<li>Die Anzahl der von der Implementation zur Verfügung gestellten Uniformvariablen wurde überschritten.</li>
<li>Der Speicherplatz für Uniformvariablen wurde überschritten.</li>
<li>Die Anzahl der von der Implementation angebotenen Sampler wurde überschritten.</li>
<li>Der Haupt-Funktionskörper(''main'') fehlt bei Vertex- oder Fragmentshader.</li>
<li>Die Liste der im Vertexshader festgelegten Varying-Variablen unterscheidet sich von der im Fragmentshader.</li>
<li>Referenzen auf nicht-definierte Funktionen oder Variablen.</li>
<li>Eine verteilte globale Variable (shared global) wurde mit unterschiedlichen Typen oder Vorgabewerten deklariert.</li>
<li>Das binden einer generischen Attribut Matrix führt dazu, dass einige Zeilen der Matrix das durch '''GL_MAX_VERTEX_ATTRIBS''' vorgegeben Maximum überschreiten.</li>
<li>Einer oder mehrere der angehängte(n) Shader wurde nicht erfolgreich kompiliert.</li>
<li>Es wurden nicht genug aufeinanderfolgende Vertex-Attribut-Slots gefunden um Attributmatrizen zu binden.</li>
</ul>

Sobald ein Programmobjekt erfolgreich gelinkt wurde, können die in ihm enthaltenen, nun ausführbaren Shader, als Teil des aktuellen Renderstatuses via [[glUseProgram]] aktiviert werden. Ob der Linkvorgang erfolgreich war, und Informationen zu diesem Vorgang können über [[glGetProgramInfoLog]] aus dem Informationslog des Programmobjektes entnommen werden.

'''glLinkProgramARB''' wird nach einem erfolgreichen Linkvorgang die ausführbaren Shader als Teil des aktuellen Renderstatuses installieren, sofern das Programmobjekt bereits als aktuelles gesetzt wurde (über [[glUseProgram]]).

Wenn ein Programm Shader vom Typ ''GL_VERTEX_SHADER_ARB'' beinhaltet, aber keinen Shader vom Typ ''GL_FRAGMENT_SHADER_ARB'', wird der Vertexshader gegen das Interface für die feste Fragmentberechnung gelinkt. Entsprechend wird ein Fragmentshader gegen das Interface für die feste Vertexberechnung gelinkt, wenn Shader vom Typ ''GL_FRAGMENT_SHADER_ARB'', aber keiner vom Typ ''GL_VERTEX_PROGRAM_ARB'' enthalten ist.

Das Informationslog des Programmobjektes wird aktualisiert, und der Satz ausführbarer Shader wird generiert, sobald der Linkvorgang ausgeführt wird. Nach dem Linken steht es der Anwendung offen, nicht mehr benötigte Shaderobjekte zu modifizieren oder zu löschen. Keine dieser Operationen werden dann die bereits kompilierten Shader des Programmobjektes verändern.

 
== Hinweise ==
'''glLinkProgram''' ist erst ab OpenGL Version 2.0 verfügbar. (Frühere Versionen können [[glLinkProgramARB]] enthalten.)

War das Linken erfolgreich gehen alle Linkinformationen zu einem vorhergehenden Linkversuch verloren (werden überschrieben). Das bedeutet z.B. das ein fehlgeschlagener Versuch nicht den alten Status von ''programObj'' wiederherstellt. Es können aber selbst dann noch einige Informationen von ''programObj'' ausgelesen werden. Siehe dazu [[glGetActiveAttrib]] und [[glGetActiveUniform]].

 
== Fehlermeldungen ==
'''GL_INVALID_VALUE''' wird generiert wenn ''programOjb'' kein gültiges Objekthandle ist.

'''GL_INVALID_OPERATION''' wird generiert wenn ''programObj'' nicht vom Typ ''GL_PROGRAM_OBJECT'' ist.

'''GL_INVALID_OPERATION''' wird generiert wenn [[glLinkProgram]] zwischen einem [[glBegin]] und dem passenden [[glEnd]] aufgerufen wird.

 
== Zugehörige Wertrückgaben ==
[[glGetActiveAttribARB]] mit dem Argument ''programObj''.

[[glGetActiveUniformARB]] mit dem Argument ''programObj''.

[[glGetInfoLogARB]] mit dem Argument ''programObj''.

[[glGetObjectParameterARB]] mit den Argumenten ''programObj'' und ''GL_OBJECT_LINK_STATUS_ARB''.

[[glGetUniformARB]] mit dem Argument ''programObj'' und dem Platz einer Uniformvariable.

[[glGetUniformLocationARB]] mit dem Argument ''programObj'' und dem Namen einer Uniformvariable.

[[glGetHandleARB]] mit dem Parameter ''GL_PROGRAM_OBJECT_ARB''.

 
== Siehe auch ==
[[glAttachObjectARB]], [[glCompileShaderARB]], [[glDetachObjectARB]], [[glUniformARB]], [[glUseProgramObjectARB]], [[glValidateProgramARB]] 
'''Hintergrundwissen :''' [[Shader]] 
[http://developer.3dlabs.com/openGL2/slapi/LinkProgramARB.htm Englische Originalversion] (Copyright 3DLabs Inc.)

[[Kategorie:GL|LinkProgramARB]]

← Nächstältere Version		Version vom 28. Juni 2005, 13:18 Uhr
Zeile 96:		Zeile 96:

	[[Kategorie:GL\|LinkProgram]]		[[Kategorie:GL\|LinkProgram]]
−	[[Kategorie:SHADER_OBJECTS\|~~CompileShader~~]]	+	[[Kategorie:SHADER_OBJECTS\|LinkProgram]]

@@ Zeile 7: / Zeile 7: @@
 <br>
 == Delphi-Spezifikation ==
-  procedure '''glLinkProgram'''(''programObj'' GLhandleARB);
+  procedure '''glLinkProgram'''(''programObj'' GLHandle);
 <br>
@@ Zeile 96: / Zeile 96: @@
 [[Kategorie:GL|LinkProgram]]

← Nächstältere Version		Version vom 28. Juni 2005, 13:16 Uhr
Zeile 1:		Zeile 1:
−	~~{{Offline}}~~
−
−
−
−
−
	= glLinkProgramARB =		= glLinkProgramARB =

@@ Zeile 95: / Zeile 95: @@
 == Siehe auch ==
-[[glAttachObjectARB]], [[glCompileShaderARB]], [[glDetachObjectARB]], [[glUniformARB]], [[glUseProgramObjectARB]], [[glValidateProgramARB]]<br>
+[[glAttachShader]], [[glBindAttribLocation]], [[glCompileShader]], [[glCreateProgram]], [[glDeleteProgram]], [[glDetachShader]], [[glUniform]], [[glUseProgram]], [[glValidateProgram]]
 '''Hintergrundwissen :''' [[Shader]]<br>
-[http://developer.3dlabs.com/openGL2/slapi/LinkProgramARB.htm Englische Originalversion]  (Copyright 3DLabs Inc.)
+[http://developer.3dlabs.com/documents/GLmanpages/glLinkProgram.htm Englische Orginalversion]  (Copyright 3DLabs Inc.)<br>
-[[Kategorie:GL|LinkProgramARB]]
+[[Kategorie:GL|LinkProgram]]

@@ Zeile 1: / Zeile 1: @@
 = glLinkProgramARB =
-<br>
 == Name ==
 '''glLinkProgram''' - linkt die momentan an ein Programmobjekt gebundenen Shader, um daraus einen Satz ausführbarer Shader zu erstellen.
-<br>
 == Delphi-Spezifikation ==
   procedure '''glLinkProgram'''(''programObj'' GLHandle);
-<br>
 == Parameter ==
@@ Zeile 20: / Zeile 23: @@
 </table>
-<br>
 == Beschreibung ==
 '''glLinkProgram''' linkt die momentan an ''programObj'' gebundenen Shader, um daraus einen Satz ausführbarer Shader zu erstellen. Wenn Shaderobjekte vom Typ ''GL_VERTEX_SHADER'' an ''programObj'' angehangen sind, werden diese genutzt um einen ausführbaren Shader zu erstellen der auf dem programmierbaren '''Vertexprozessor''' abläuft. Sind Shaderobjekte vom Typ ''GL_FRAGMENT_SHADER'' an ''programObj'' angehangen, so werden diese genutzt um den ausführbaren Shader zu erstellen der auf dem programmierbaren '''Fragmentprozessor''' läuft.
@@ Zeile 51: / Zeile 55: @@
 Das Informationslog des Programmobjektes wird aktualisiert, und der Satz ausführbarer Shader wird generiert, sobald der Linkvorgang ausgeführt wird. Nach dem Linken steht es der Anwendung offen, nicht mehr benötigte Shaderobjekte zu modifizieren oder zu löschen. Keine dieser Operationen werden dann die bereits kompilierten Shader des Programmobjektes verändern.
-<br>
 == Hinweise ==
 '''glLinkProgram''' ist erst ab OpenGL Version 2.0 verfügbar. (Frühere Versionen können [[glLinkProgramARB]] enthalten.)
@@ Zeile 57: / Zeile 62: @@
 War das Linken erfolgreich gehen alle Linkinformationen zu einem vorhergehenden Linkversuch verloren (werden überschrieben). Das bedeutet z.B. das ein fehlgeschlagener Versuch nicht den alten Status von ''programObj'' wiederherstellt. Es können aber selbst dann noch einige Informationen von ''programObj'' ausgelesen werden. Siehe dazu [[glGetActiveAttrib]] und [[glGetActiveUniform]].
-<br>
 == Fehlermeldungen ==
 '''GL_INVALID_VALUE''' wird generiert wenn ''programOjb'' kein gültiges Objekthandle ist.
@@ Zeile 65: / Zeile 71: @@
 '''GL_INVALID_OPERATION''' wird generiert wenn [[glLinkProgram]] zwischen einem [[glBegin]] und dem passenden [[glEnd]] aufgerufen wird.
-<br>
 ==  Zugehörige Wertrückgaben ==
 [[glGet]] mit dem Token [[glGet#GL_CURRENT_PROGRAM|GL_CURRENT_PROGRAM]].
@@ Zeile 87: / Zeile 94: @@
 [[glIsProgram]]
-<br>
 == Siehe auch ==

← Nächstältere Version	Version vom 5. Dezember 2005, 19:29 Uhr
(kein Unterschied)

@@ Zeile 72: / Zeile 72: @@
 <br>
 ==  Zugehörige Wertrückgaben ==
-[[glGetActiveAttribARB]] mit dem Argument ''programObj''.
+[[glGet]] mit dem Token [[glGet#GL_CURRENT_PROGRAM|GL_CURRENT_PROGRAM]].
-[[glGetActiveUniformARB]] mit dem Argument ''programObj''.
+[[glGetActiveAttrib]] mit dem Argument ''programObj'' und dem Index einer aktiven Attributvariable.
-[[glGetInfoLogARB]] mit dem Argument ''programObj''.
+[[glGetActiveUniform]] mit dem Argument ''programObj'' und dem Index einer aktiven Uniformvariable.
-[[glGetObjectParameterARB]] mit den Argumenten ''programObj'' und ''GL_OBJECT_LINK_STATUS_ARB''.
+[[glGetAttachedShaders]] mit dem Argument ''programObj''.
-[[glGetUniformARB]] mit dem Argument ''programObj'' und dem Platz einer Uniformvariable.
+[[glGetAttribLocation]] mit dem Argument ''programObj'' und dem Namen einer Attributvariable.
-[[glGetUniformLocationARB]] mit dem Argument ''programObj'' und dem Namen einer Uniformvariable.
+[[glGetProgram]] mit den Argumenten ''programObj'' und '''GL_LINK_STATUS'''.
-[[glGetHandleARB]] mit dem Parameter ''GL_PROGRAM_OBJECT_ARB''.
+[[glGetProgramInfoLog]] mit den Argumenten ''programObj''
 <br>
 == Siehe auch ==
 [[glAttachObjectARB]], [[glCompileShaderARB]], [[glDetachObjectARB]], [[glUniformARB]], [[glUseProgramObjectARB]], [[glValidateProgramARB]]<br>