glGenQueries: Unterschied zwischen den Versionen
(neu erstellt) |
(→Fehlermeldungen) |
||
| (Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
= glGenQueries = | = glGenQueries = | ||
| − | + | ||
| + | |||
== Name == | == Name == | ||
'''glGenQueries''' - Gibt unbenutzte [[Occlusion Query]]-Objektnamen zurück. | '''glGenQueries''' - Gibt unbenutzte [[Occlusion Query]]-Objektnamen zurück. | ||
| − | + | ||
| + | |||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
procedure '''glGenQueries'''(''n'': GLsizei; ''ids'': PGLuint) | procedure '''glGenQueries'''(''n'': GLsizei; ''ids'': PGLuint) | ||
| − | + | ||
| + | |||
== Parameter == | == Parameter == | ||
| Zeile 21: | Zeile 24: | ||
|} | |} | ||
| − | + | ||
| + | |||
== Beschreibung == | == Beschreibung == | ||
| Zeile 30: | Zeile 34: | ||
Es werden nur positive Ids zurückgegeben. 0 wird niemals als gültiger Wert von '''glGenQueries''' zurückgegeben, da dies ein reservierter Occlusion-Query-Objektname ist. | Es werden nur positive Ids zurückgegeben. 0 wird niemals als gültiger Wert von '''glGenQueries''' zurückgegeben, da dies ein reservierter Occlusion-Query-Objektname ist. | ||
| − | + | ||
| + | |||
== Hinweise == | == Hinweise == | ||
| Zeile 40: | Zeile 45: | ||
;'''GL_INVALID_OPERATION''': glGenQueries wurde innerhalb eines [[glBeginQuery]]-[[glEndQuery]] Blocks aufgerufen. <br> | ;'''GL_INVALID_OPERATION''': glGenQueries wurde innerhalb eines [[glBeginQuery]]-[[glEndQuery]] Blocks aufgerufen. <br> | ||
| − | + | ;'''GL_INVALID_OPERATION''': eine beliebige Query ist aktiv (d.h. Query wurde mit [[glBeginQuery]] gestartet, aber noch nicht mit [[glEndQuery]] beendet). | |
== Zugehörige Wertrückgaben == | == Zugehörige Wertrückgaben == | ||
| Zeile 46: | Zeile 51: | ||
[[glGetQuery]] mit Token '''GL_QUERY_COUNTER_BITS''' gibt die Anzahl der Bits des Occlusion-Query-Zählers zurück.<br> | [[glGetQuery]] mit Token '''GL_QUERY_COUNTER_BITS''' gibt die Anzahl der Bits des Occlusion-Query-Zählers zurück.<br> | ||
| − | + | ||
| + | |||
== Siehe auch == | == Siehe auch == | ||
Aktuelle Version vom 27. Juni 2006, 10:16 Uhr
Inhaltsverzeichnis
glGenQueries
Name
glGenQueries - Gibt unbenutzte Occlusion Query-Objektnamen zurück.
Delphi-Spezifikation
procedure glGenQueries(n: GLsizei; ids: PGLuint)
Parameter
| n | Anzahl der Query-Objektnamen, die zurückgegeben werden sollen. |
|---|---|
| ids | Zeiger auf ein Array, welches mit unbenutzten Query-Objektnamen gefüllt werden soll. |
Beschreibung
glGenQueries gibt n momentan unbenutzte Namen für Occlusion-Query-Objekte im Feld ids zurück. Die Namen, welche mit ids zurückgegeben werden, müssen nicht unbedingt aufeinanderfolgende Integerwerte sein.
Die zurückgegebenen Namen werden als benutzt gekennzeichnet, aber solange sie noch nicht mittels einem glBeginQuery-Befehl benutzt werden, wird kein Occlusion-Query-Objekt diesem Namen zugewiesen.
Es werden nur positive Ids zurückgegeben. 0 wird niemals als gültiger Wert von glGenQueries zurückgegeben, da dies ein reservierter Occlusion-Query-Objektname ist.
Hinweise
glGenQueries ist erst ab OpenGL 1.5 oder höher verfügbar.
Query-Objekte haben als einzigen Zustand einen Integer-Ergebniswert. Wenn ein Objekt erzeugt wird, wird dieser Ergebniswert auf 0 gesetzt.
Fehlermeldungen
- GL_INVALID_OPERATION
- glGenQueries wurde innerhalb eines glBeginQuery-glEndQuery Blocks aufgerufen.
- GL_INVALID_OPERATION
- eine beliebige Query ist aktiv (d.h. Query wurde mit glBeginQuery gestartet, aber noch nicht mit glEndQuery beendet).
Zugehörige Wertrückgaben
glGetQuery mit Token GL_CURRENT_QUERY gibt die momentan aktive Query-ID zurück.
glGetQuery mit Token GL_QUERY_COUNTER_BITS gibt die Anzahl der Bits des Occlusion-Query-Zählers zurück.
Siehe auch
glBeginQuery, glDeleteQueries, glEndQuery, glGetQuery, glGetQueryObject, glIsQuery,
