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
GL _ INVALID _ ENUM
target oder query war kein akzeptierter Wert.
UNGÜLTIGER _ _ GL-VORGANG
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glEnd

glEvalCoord

glMap1

glMap2