glGetMapiv-Funktion
Die Funktionen glGetMapdv, glGetMapfvund glGetMapiv geben Auswertungsparameter zurück.
Syntax
void WINAPI glGetMapiv(
GLenum target,
GLenum query,
GLint *v
);
Parameter
-
Ziel
-
Der symbolische Name einer Zuordnung. Folgende Werte werden 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.
-
query
-
Gibt an, welcher Parameter zurückgegeben werden soll. Die folgenden symbolischen Namen werden akzeptiert.
Wert Bedeutung - GL _ COEFF
Der v-Parameter gibt die Steuerungspunkte für die Auswertungsfunktion zurück. Eindimensionale Auswertungen geben Kontrollpunkte für die Reihenfolge zurück, und zweidimensionale Auswertungen geben uorder x vorder-Kontrollpunkte zurück. Jeder Steuerungspunkt besteht je nach Typ der Auswertung aus einem, zwei, drei oder vier ganzzahligen Gleitkommawerten mit einfacher Genauigkeit oder Gleitkommawerten mit doppelter Genauigkeit. Zweidimensionale Kontrollpunkte werden in Zeilen-Hauptreihenfolge zurückgegeben, wodurch der UORDER-Index schnell erhöht wird, und der vordere Index nach jeder Zeile. Ganzzahlige Werte werden bei Anforderung 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 durch glMap1angegeben. Zweidimensionale Auswertungen geben vier Werte zurück (u1, u2, v1 und v2), wie von glMap2angegeben. Ganzzahlige Werte werden bei Anforderung 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 glEndaufgerufen. |
Bemerkungen
Die glGetMap-Funktionen geben 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 zeigt auf den Speicher, in dem die Werte zurückgegeben werden.
Die zulässigen Werte für den Zielparameter werden in glMap1 und glMap2beschrieben.
Wenn ein Fehler generiert wird, werden keine Änderungen am Inhalt von v vorgenommen.
Requirements (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 |
|