glGetMapiv-Funktion

Die Funktionen glGetMapdv, glGetMapfv und glGetMapiv geben Evaluatorparameter zurück.

Syntax

void WINAPI glGetMapiv(
   GLenum target,
   GLenum query,
   GLint  *v
);

Parameter

Ziel

Der symbolische Name einer Karte. Die folgenden 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.

Frage

Gibt an, welcher Parameter zurückgegeben werden soll. Die folgenden symbolischen Namen werden akzeptiert.

Wert Bedeutung
GL_COEFF
Der Parameter v gibt die Kontrollpunkte für die Evaluatorfunktion zurück. Eindimensionale Evaluatoren geben Ordnungskontrollpunkte zurück, und zweidimensionale Evaluatoren geben uorderxvorder-Kontrollpunkte zurück. Jeder Kontrollpunkt besteht je nach Typ des Evaluators aus einem, zwei, drei oder vier ganzzahligen Gleitkommawerten mit einfacher Genauigkeit oder Gleitkommawerten mit doppelter Genauigkeit. Zweidimensionale Steuerpunkte werden in Zeilen-Hauptreihenfolge zurückgegeben, wodurch der uorder-Index und der vorder-Index nach jeder Zeile schnell erhöht werden. Ganzzahlige Werte werden bei Bedarf berechnet, indem die internen Gleitkommawerte auf die nächsten ganzzahligen Werte gerundet werden.
GL_ORDER
Der Parameter v gibt die Reihenfolge der Evaluatorfunktion zurück. Eindimensionale Evaluatoren geben einen einzelnen Wert ( Reihenfolge) zurück. Zweidimensionale Evaluatoren geben zwei Werte zurück: uorder und vorder.
GL_DOMAIN
Der Parameter v gibt die linearen u- und v-Zuordnungsparameter zurück. Eindimensionale Evaluatoren geben zwei Werte zurück, u 1 und u 2, wie von glMap1 angegeben. Zweidimensionale Evaluatoren geben vier Werte (u1, u2, v1 und v2) zurück, wie von glMap2 angegeben. Ganzzahlige Werte werden bei Bedarf 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.
GL_INVALID_OPERATION
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glGetMap-Funktionen geben Evaluatorparameter zurück. (Die Funktionen glMap1 und glMap2 definieren Evaluatoren.) Der Zielparameter gibt eine Zuordnung an, die Abfrage wählt einen bestimmten Parameter aus und v verweist auf den Speicher, in 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

Siehe auch

glBegin

glEnd

glEvalCoord

glMap1

glMap2