glGenTextures: Unterschied zwischen den Versionen
(→Parameter) |
K (Fehlermeldungen ergänzt; Kategorisierung ausgebessert.) |
||
| (6 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
= glGenTextures= | = glGenTextures= | ||
| − | + | ||
| + | |||
== Name == | == Name == | ||
| − | '''glGenTextures''' | + | '''glGenTextures''' - Gibt eine bestimmte Anzahl an freien Texturnamen zurück. |
| + | |||
| + | |||
| − | |||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
procedure '''glGenTextures'''(''n'': GLsizei; ''textures'': PGLuint); | procedure '''glGenTextures'''(''n'': GLsizei; ''textures'': PGLuint); | ||
| − | + | ||
| + | |||
== Parameter == | == Parameter == | ||
| Zeile 20: | Zeile 23: | ||
|} | |} | ||
| − | + | ||
== Beschreibung == | == Beschreibung == | ||
| − | '''glGenTextures''' gibt | + | '''glGenTextures''' gibt ''n'' momentan nicht genutzte Texturnamen (beliebige positive Integerwerte) im Array ''textures'' zurück. Die Verwendung von '''glGenTextures''' stellt sicher, dass Texturnamen nicht versehentlich doppelt verwendet werden, denn es werden nur solche Namen zurückgeliefert, die beim Aufruf der Funktion '''glGenTextures''' garantiert nicht benutzt wurden. |
| + | |||
| + | Die generierten Texturen erhalten die Dimension des Texturziels, an das sie zuerst mit [[glBindTexture]] gebunden wurden. | ||
| + | |||
| + | Ein Texturname kann erst dann wieder durch '''glGenTextures''' zurückgeliefert werden, wenn er zuvor mittels [[glDeleteTextures]] freigegeben wurde. | ||
| + | |||
| + | |||
| − | |||
== Hinweise == | == Hinweise == | ||
| − | Die zurückgegebenen Texturnamen müssen nicht zwingend aufeinanderfolgende Integerwerte sein. Der reservierte Texturname 0 wird dabei niemals zurückgegeben. | + | Die zurückgegebenen Texturnamen müssen nicht zwingend aufeinanderfolgende Integerwerte sein. |
| + | |||
| + | Der reservierte Texturname 0 wird dabei niemals zurückgegeben. | ||
| + | |||
| + | Diese Funktion ist erst ab OpenGL-Version 1.1 oder höher enthalten. | ||
| + | |||
| + | |||
| + | |||
| + | == Fehlermeldungen == | ||
| + | '''GL_INVALID_OPERATION''' wird generiert wenn '''glGenTextures''' innerhalb eines [[glBegin]]-[[glEnd]]-Blocks aufgerufen wird. | ||
| + | |||
| + | '''GL_INVALID_VALUE''' wird generiert, wenn ''n'' negativ ist. | ||
| + | |||
| + | |||
| + | |||
| + | == Zugehörige Wertrückgaben == | ||
| + | [[glIsTexture]] | ||
| + | |||
| − | |||
== Siehe auch == | == Siehe auch == | ||
| − | [[glIsTexture]],[[glDeleteTextures]],[[glBindTexture]] | + | [[glIsTexture]], [[glDeleteTextures]], [[glBindTexture]] |
| + | |||
| + | [[Kategorie:GL|GenTextures]] | ||
| + | [[Kategorie:GL1.1|GenTextures]] | ||
Aktuelle Version vom 20. September 2010, 02:42 Uhr
Inhaltsverzeichnis
glGenTextures
Name
glGenTextures - Gibt eine bestimmte Anzahl an freien Texturnamen zurück.
Delphi-Spezifikation
procedure glGenTextures(n: GLsizei; textures: PGLuint);
Parameter
| n | Gibt die Anzahl der Texturen an, für die momentan ungenutzte Texturnamen zurückgegeben werden sollen. |
| textures | Pointer auf einen GLuint-Array, in welchem die Texturnamen gespeichert werden sollen |
Beschreibung
glGenTextures gibt n momentan nicht genutzte Texturnamen (beliebige positive Integerwerte) im Array textures zurück. Die Verwendung von glGenTextures stellt sicher, dass Texturnamen nicht versehentlich doppelt verwendet werden, denn es werden nur solche Namen zurückgeliefert, die beim Aufruf der Funktion glGenTextures garantiert nicht benutzt wurden.
Die generierten Texturen erhalten die Dimension des Texturziels, an das sie zuerst mit glBindTexture gebunden wurden.
Ein Texturname kann erst dann wieder durch glGenTextures zurückgeliefert werden, wenn er zuvor mittels glDeleteTextures freigegeben wurde.
Hinweise
Die zurückgegebenen Texturnamen müssen nicht zwingend aufeinanderfolgende Integerwerte sein.
Der reservierte Texturname 0 wird dabei niemals zurückgegeben.
Diese Funktion ist erst ab OpenGL-Version 1.1 oder höher enthalten.
Fehlermeldungen
GL_INVALID_OPERATION wird generiert wenn glGenTextures innerhalb eines glBegin-glEnd-Blocks aufgerufen wird.
GL_INVALID_VALUE wird generiert, wenn n negativ ist.
Zugehörige Wertrückgaben
