glGetMap

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glGetMap

Name

glGetMap - liefert die Parameter der Evaluatoren (bedeutet zu Deutsch so viel wie ("Auswerten").


Delphi-Spezifikation

procedure glGetMapdv(target: TGLenum; query: TGLenum; v: PGLdouble);
procedure glGetMapfv(target: TGLenum; query: TGLenum; v: PGLfloat);
procedure glGetMapiv(target: TGLenum; query: TGLenum; v: PGLint);


Parameter

target Ist der symbolische Name einer Karte. Akzeptiert werden:

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,undGL_MAP2_VERTEX_4.

query Bestimmt welche Parameter zurückgeliefert werden sollen. Als symbolische Namen werden GL_COEFF, GL_ORDER, und GL_DOMAIN akzeptiert.
v Ist ein Zeiger auf die abgefragten Daten.



Beschreibung

glGetMap liefert die Evaluatoren Parameter. (glMap1 und glMap2 sind Parameter.) target selektiert eine Karte, query bestimmt die abzufragende Eigenschaft und v zeigt auf den Speicherbereich, in den die Ergebnisse der Abfrage abgelegt werden sollen.

Die Bedeutung der Parameter, die man target übergeben kann, können Sie unter glMap1 und glMap2 nachlesen.

Dem Parameter query kan man folgende Werte zuweisen:

GL_COEFF

v liefert die Stützstellen (control points) für die Evaluatoren-Funktion. 1D-Evaluatoren liefern order Kontrollpunkte zurück, 2D-Evaluatoren liefern uorder * vorder Kontrollpunkte zurück. Jeder Kontrollpunkt besteht aus ein, zwei, drei oder vier Ganzzahl-, Single-, oder Double-Fließkommawerten, je nach Typ des Evaluators. 2D-Kontrollpunkte werden in reihenbetonter Sortierung zurückgegeben, wobei zuerst immer uorder erhöht, und nach jeder Reihe vorder erhöht wird.
Ganzzahlen werden, wenn abgefragt, bestimmt durch Runden der internen Fließkommarepräsentation zur nächsten Ganzzahl.

GL_ORDER

v liefert den Rang der Evaluatoren-Funktion zurück.
Eindimensionale Evaluatoren liefern einen einzelnen Wert, order. Zweidimensionale Evaluatoren liefern zwei Werte, uorder und vorder.

GL_DOMAIN

v liefert die linearen UV-Mapping Parameter, u und v.
Eindimensionale Evaluatoren liefern zwei Werte, u1 und u2, entsprechend der Definition durch glMap1.
Zweidimensionale Evaluatoren liefern vier Werte (u1, u2, v1 und v2), die der Definition durch glMap2 entsprechen.
Ganzzahlen werden, wenn abgefragt, bestimmt durch Runden der internen Fließkommarepräsentation zur nächsten Ganzzahl.



Hinweise

Wenn während der Ausführung der Funktion ein Fehler auftritt, wird der Inhalt von v nicht verändert.


Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn entweder target oder query ein ungültiger Wert übergeben wird.

GL_INVALID_OPERATION wird generiert, wenn glGetMap innerhalb eines glBegin-glEnd-Blocks aufgerufen wird.


Siehe auch

glEvalCoord, glMap1, glMap2