glGetMapfv-Funktion
Die Funktionen glGetMapdv, glGetMapfv und glGetMapiv geben Auswertungsparameter zurück.
Syntax
void WINAPI glGetMapfv(
GLenum target,
GLenum query,
GLfloat *v
);
Parameter
-
Ziel
-
Der symbolische Name einer Karte. Folgende Werte sind akzeptiert: GL _ MAP1 _ COLOR _ 4, GL _ MAP1 _ INDEX, GL _ MAP1 _ NORMAL, GL _ MAP1 _ TEXTURE _ COORD _ 1, GL _ MAP1 TEXTURE _ _ COORD _ 2, GL _ MAP1 TEXTURE _ _ COORD _ 3, GL _ MAP1 TEXTURE _ _ COORD _ 4, GL _ MAP1 _ VERTEX _ 3, GL _ MAP1 _ VERTEX _ 4, GL _ MAP2 COLOR _ _ 4, GL _ MAP2 _ INDEX, GL _ _ MAP2 NORMAL, GL _ MAP2 TEXTURE _ _ COORD _ 1, GL _ MAP2 TEXTURE _ _ COORD _ 2, GL _ MAP2 TEXTURE _ _ COORD _ 3, GL _ MAP2 TEXTURE _ _ COORD _ 4, GL _ MAP2 _ VERTEX 3 und _ GL _ MAP2 _ VERTEX _ 4.
-
Frage
-
Gibt an, welcher Parameter zurückgibt. Die folgenden symbolischen Namen werden akzeptiert.
Wert Bedeutung - GL _ COEFF
Der v-Parameter gibt die Kontrollpunkte für die Auswertungsfunktion zurück. Eindimensionale Auswertungen geben Steuerungspunkte für die Reihenfolge zurück, und zweidimensionale Auswertungen geben uorder x vordere Kontrollpunkte zurück. Jeder Kontrollpunkt besteht je nach Typ der Auswertung aus einem, zwei, drei oder vier ganzen Zahlen, Gleitkommawerten mit einzelner Genauigkeit oder Gleitkommawerten mit doppelter Genauigkeit. Zweidimensionale Kontrollpunkte werden in zeilenweiser Reihenfolge zurückgegeben und erhöhen den uorder-Index schnell und den vorderen Index nach jeder Zeile. Ganzzahlige Werte werden, wenn sie angefordert werden, berechnet, indem die internen Gleitkommawerte auf die nächsten ganzzahligen Werte gerundet werden. - GL _ ORDER
Der v-Parameter gibt die Reihenfolge der Auswertungsfunktion zurück. Eindimensionale Auswertungen geben einen einzelnen Wert in der Reihenfolge zurück. Zweidimensionale Auswertungen geben zwei Werte zurück: uorder und vorder. - GL _ DOMAIN
Der v-Parameter gibt die linearen u- und v-Zuordnungsparameter zurück. Eindimensionale Auswertungen geben zwei Werte zurück, u 1 und u 2, wie von glMap1 angegeben. Zweidimensionale Auswertungen geben vier Werte zurück (u1, u2, v1 und v2), wie von glMap2 angegeben. Ganzzahlige Werte werden, wenn sie angefordert werden, berechnet, indem die internen Gleitkommawerte auf die nächsten ganzzahligen Werte gerundet werden. -
V
-
Gibt die angeforderten Daten zurück.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
target oder query war kein akzeptierter Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Hinweise
Die glGetMap-Funktion gibt Auswertungsparameter zurück. (Die Funktionen glMap1 und glMap2 definieren Auswertungen.) Der Zielparameter gibt eine Zuordnung an, die Abfrage wählt einen bestimmten Parameter aus, und v zeigt auf den Speicher, an dem die Werte zurückgegeben werden.
Die zulässigen Werte für den Zielparameter werden in glMap1 und glMap2 beschrieben.
Wenn ein Fehler generiert wird, wird keine Änderung am Inhalt von v vorgenommen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|