glLinkProgramARB - Versionsgeschichte

DGLBot: Bot: konvertiere/korrigiere

2006-04-22T18:22:24Z

Bot: konvertiere/korrigiere

Flash am 18. April 2006 um 14:15 Uhr

2006-04-18T14:15:52Z

DGLBot: GlLinkProgramARB wurde nach glLinkProgramARB verschoben

2005-12-05T19:29:35Z

GlLinkProgramARB wurde nach glLinkProgramARB verschoben

Flash am 23. Juni 2005 um 09:11 Uhr

2005-06-23T09:11:30Z

Flo: /* Siehe auch */

2004-08-19T20:04:01Z

‎Siehe auch

Fiji-Fighter: Trennlinien entfernt

2004-08-16T00:04:43Z

Trennlinien entfernt

2004-07-31T00:26:31Z

Sascha Willems am 13. Juli 2004 um 19:56 Uhr

2004-07-13T19:56:56Z

Neue Seite

= glLinkProgramARB =

 
== Name ==
----
'''Name der Funktion''' - Beschreibung...

 
== 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 ==
----
'''glLinkProgramARB''' linkt die momentan an ein Programmobjekt gebundenen Shader, um daraus einen Satz ausführbarer Shader zu erstellen. Wenn ein Shaderobjekt vom Typ ''GL_VERTEX_SHADER_ARB'' an das Programmobjekt angehangen ist, wird dieses genutzt um den ausführbaren Shader zu erstellen der auf dem programmierbaren Vertexprozessor abläuft. Ist ein Shaderobjekt vom Typ ''GL_FRAGMENT_SHADER_ARB'' an das Programmobjekt angehangen, so wird dieses 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 des Programmobjektes abgelegt, und ist True, wenn das Programmobjekt ohne Fehler gelinkt wird, bzw. False, wenn dies nicht der Fall ist. Abgefragt kann dieser Status über den Befehl [[glGetObjectParamterARB]] mit den Argumenten ''programObj'' und ''GL_OBJECT_LINK_STATUS_ARB'' 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 [[glGetUniformLocationARB]] angefragt werden kann. 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>Der Speicherplatz für Uniformvariablen wurde aufgebraucht.</li>
<li>Die Anzahl der von der Implementation angebotenen Sampler wurde überschritten.</li>
<li>Der Haupt-Funktionskörper(''main'') fehlt.</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 wurde mit unterschiedlichen Typen oder Vorgabewerten deklariert.</li>
<li>Zwei verschiedene Samplervariablen zeigen auf die gleiche Textureinheit.</li>
<li>Einer oder mehrere der angehängte(n) Shader wurde nicht erfolgreich kompiliert.</li>
</ul>

Sobald ein Programmobjekt erfolgreich gelinkt wurde, können die in ihm enthaltenen, nun ausführbaren Shader, als Teil des aktuellen Renderstatuses via [[glUseProgramObjectARB]] aktiviert werden. Ob der Linkvorgang erfolgreich war, und Informationen zu diesem Vorgang können über [[glGetInfoLogARB]] 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 [[glUseProgramObjectARB]]).

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.

 
== 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_ARB'' ist.

'''GL_INVALID_OPERATION''' wird generiert wenn [[glLinkProgramARB]] 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.)

← Nächstältere Version		Version vom 18. April 2006, 14:15 Uhr
Zeile 1:		Zeile 1:
		+	{{Veraltet\|glLinkProgram}}
	= glLinkProgramARB =		= glLinkProgramARB =
−
−	~~{{Hinweis\|Dieser Artikel beschreibt eine veraltete Version der Funktion. Die aktuelle Funktion finden Sie unter '''[[glLinkProgram]]'''.}}~~

	<br>		<br>

← Nächstältere Version		Version vom 19. August 2004, 20:04 Uhr
Zeile 74:		Zeile 74:
	'''Hintergrundwissen :''' [[Shader]]<br>		'''Hintergrundwissen :''' [[Shader]]<br>
	[http://developer.3dlabs.com/openGL2/slapi/LinkProgramARB.htm Englische Originalversion] (Copyright 3DLabs Inc.)		[http://developer.3dlabs.com/openGL2/slapi/LinkProgramARB.htm Englische Originalversion] (Copyright 3DLabs Inc.)
		+
		+	[[Kategorie:GL\|LinkProgramARB]]

@@ Zeile 2: / Zeile 2: @@
 = glLinkProgramARB =
-<br>
 == Name ==
 '''glLinkProgramARB''' - linkt die momentan an ein Programmobjekt gebundenen Shader, um daraus einen Satz ausführbarer Shader zu erstellen.
-<br>
 == Delphi-Spezifikation ==
   procedure '''glLinkProgramARB'''(''programObj'' GLhandleARB);
-<br>
 == Parameter ==
 <table border=1 rules=all>
@@ Zeile 19: / Zeile 22: @@
 </table>
-<br>
 == Beschreibung ==
 '''glLinkProgramARB''' linkt die momentan an ein Programmobjekt gebundenen Shader, um daraus einen Satz ausführbarer Shader zu erstellen. Wenn ein Shaderobjekt vom Typ ''GL_VERTEX_SHADER_ARB'' an das Programmobjekt angehangen ist, wird dieses genutzt um den ausführbaren Shader zu erstellen der auf dem programmierbaren Vertexprozessor abläuft. Ist ein Shaderobjekt vom Typ ''GL_FRAGMENT_SHADER_ARB'' an das Programmobjekt angehangen, so wird dieses genutzt um den ausführbaren Shader zu erstellen der auf dem programmierbaren Fragmentprozessor läuft.
@@ Zeile 46: / Zeile 50: @@
 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>
 == Fehlermeldungen ==
 '''GL_INVALID_VALUE''' wird generiert wenn ''programOjb'' kein gültiges Objekthandle ist.
@@ Zeile 54: / Zeile 59: @@
 '''GL_INVALID_OPERATION''' wird generiert wenn [[glLinkProgramARB]] zwischen einem [[glBegin]] und dem passenden [[glEnd]] aufgerufen wird.
-<br>
 ==  Zugehörige Wertrückgaben ==
 [[glGetActiveAttribARB]] mit dem Argument ''programObj''.
@@ Zeile 70: / Zeile 76: @@
 [[glGetHandleARB]] mit dem Parameter ''GL_PROGRAM_OBJECT_ARB''.
-<br>
 == Siehe auch ==
 [[glAttachObjectARB]], [[glCompileShaderARB]], [[glDetachObjectARB]], [[glUniformARB]], [[glUseProgramObjectARB]], [[glValidateProgramARB]]<br>

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