glGenTextures: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(Siehe auch)
K (Fehlermeldungen ergänzt; Kategorisierung ausgebessert.)
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 4: Zeile 4:
  
 
== Name ==
 
== Name ==
'''glGenTextures''' - gibt eine bestimmte Anzahl an freien Texturnamen zurück.
+
'''glGenTextures''' - Gibt eine bestimmte Anzahl an freien Texturnamen zurück.
  
  
Zeile 22: Zeile 22:
 
| Pointer auf einen GLuint-Array, in welchem die Texturnamen gespeichert werden sollen
 
| Pointer auf einen GLuint-Array, in welchem die Texturnamen gespeichert werden sollen
 
|}
 
|}
 
  
  
  
 
== Beschreibung ==
 
== 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.
+
'''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.
 
Die generierten Texturen erhalten die Dimension des Texturziels, an das sie zuerst mit [[glBindTexture]] gebunden wurden.
Zeile 33: Zeile 32:
 
Ein Texturname kann erst dann wieder durch '''glGenTextures''' zurückgeliefert werden, wenn er zuvor mittels [[glDeleteTextures]] freigegeben wurde.
 
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.
  
  
  
== Hinweise ==
+
== Fehlermeldungen ==
Die zurückgegebenen Texturnamen  müssen nicht zwingend aufeinanderfolgende Integerwerte sein. <br>
+
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGenTextures''' innerhalb eines [[glBegin]]-[[glEnd]]-Blocks aufgerufen wird.
Der reservierte Texturname 0 wird dabei niemals zurückgegeben. <br>
+
 
Diese Funktion ist erst ab OpenGL Version 1.1 oder höher enthalten.
+
'''GL_INVALID_VALUE''' wird generiert, wenn ''n'' negativ ist.
 +
 
 +
 
  
 +
== Zugehörige Wertrückgaben ==
 +
[[glIsTexture]]
  
  
Zeile 48: Zeile 59:
  
 
[[Kategorie:GL|GenTextures]]
 
[[Kategorie:GL|GenTextures]]
[[Kategorie:GL1.0]]
+
[[Kategorie:GL1.1|GenTextures]]

Aktuelle Version vom 20. September 2010, 01:42 Uhr

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

glIsTexture


Siehe auch

glIsTexture, glDeleteTextures, glBindTexture