Version vom 18. November 2005, 18:26 Uhr

Hinweis: Dieser Artikel ist noch unvollständig. (Mehr Informationen/weitere Artikel) {{{1}}}

glAttachShader

Name

glAttachShader - Hängt ein Shaderobjekt an ein Programmobjekt.

Delphi-Spezifikation

procedure glAttachShader(program : GLuint; shader : GLuint);

Parameter

Beschreibung

Um eine ausführbare Datei zu erzeugen, muss man die Liste der Dinge angeben, die verlinkt werden sollen. Programmobjekte bieten einen Methode dafür. Shader, die in einem Programmobjekt verlinkt werden sollen, müssen erst an dieses Programmobjekt gebunden werden. glAttachShader bindet das Shaderobjekt - angegeben durch shader - an das Programmobjekt, das mit program angegeben wurde. Das bedeuted, dass dieser Shader gelinkt wird, sobald das Programm gelinkt wird.

Alle Operationen, die auf ein Shaderobjekt angewendet werden können, sind zulässig, egal, ob das Shaderobjekt an ein Programmobjekt gebunden wurde. Es ist zulässig, ein Shaderobjekt an ein Programmobjekt zu binden, bevor der Sourcecode ins Shaderobjekt geladen wurde oder bevor das Shaderobjekt kompiliert wurde. Es ist auch zulässig, mehrere Shaderobjekte des selben Typs anzubinden, die sie einen Teil des ganzen Shaders beinhalten könnten. Es ist weiter möglich, ein Shaderobjekt an mehr als ein Programmobjekt zu binden. Wenn ein Shaderobjekt gelöscht wird, während es an ein Programmobjekt gebunden ist, wird es als zu löschend markiert und das Löschen wird nicht durchgeführt, bis glDetachShader aufgerufen wird, um das Shaderobjekt von allen Programmobjekten zu lösen, an die es angebunden ist.

In order to create an executable, there must be a way to specify the list of things that will be linked together. Program objects provide this mechanism. Shaders that are to be linked together in a program object must first be attached to that program object. glAttachShader attaches the shader object specified by shader to the program object specified by program . This indicates that shader will be included in link operations that will be performed on program.

All operations that can be performed on a shader object are valid whether or not the shader object is attached to a program object. It is permissible to attach a shader object to a program object before source code has been loaded into the shader object or before the shader object has been compiled. It is permissible to attach multiple shader objects of the same type because each may contain a portion of the complete shader. It is also permissible to attach a shader object to more than one program object. If a shader object is deleted while it is attached to a program object, it will be flagged for deletion, and deletion will not occur until glDetachShader is called to detach it from all program objects to which it is attached.

Hinweise

glAttachShader ist erst ab OpenGL Version 2.0 verfügbar.

Fehlermeldungen

GL_INVALID_VALUE wird generiert wenn shader oder program keine von OpenGL gernerierten Werte enthält.
GL_INVALID_OPERATION wird generiert wenn program nicht vom Typ GL_PROGRAM_OBJECT ist.
GL_INVALID_OPERATION wird generiert wenn shader nicht vom Typ GL_SHADER_OBJECT ist.
GL_INVALID_OPERATION wird generiert wenn shader bereits an program gebunden ist.
GL_INVALID_OPERATION wird generiert wenn glAttachShader innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Zugehörige Wertrückgaben

glGetAttachedShaders mit dem Handle auf ein gültiges Programmobjekt.

glIsProgram

glIsShader

Siehe auch

glCompileShader, glDetachShader, glLinkProgram, glShaderSource