Freigeben über


glGetMapdv-Funktion

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

Syntax

void WINAPI glGetMapdv(
   GLenum   target,
   GLenum   query,
   GLdouble *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 v-Parameter gibt die Steuerpunkte für die Auswertungsfunktion zurück. Eindimensionale Auswertung gibt Ordnungssteuerungspunkte zurück, und zweidimensionale Auswerter geben uorderxvordere Kontrollpunkte zurück. Jeder Kontrollpunkt besteht aus gleitkommabasierten Gleitkommawerten mit einer, zwei, drei oder vier ganzzahligen, gleitkommagenauen oder doppelten Genauigkeit, je nach Typ des Evaluators. 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 Bedarf 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 ( 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 Auswertung gibt zwei Werte zurück, u 1 und u2 , wie von glMap1 angegeben. Zweidimensionale Evaluatoren geben vier Werte (u1, u2, v1 und v2) zurück, wie in 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-Funktion gibt Auswertungsparameter zurück. (Die Funktionen glMap1 und glMap2 definieren Evaluatoren.) Der Zielparameter gibt eine Zuordnung an, die Abfrage einen bestimmten Parameter 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