glGetMap: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Beschreibung: Konstanten Verlinkbar gemacht)
K (GlGetMap wurde nach glGetMap verschoben)
(kein Unterschied)

Version vom 5. Dezember 2005, 20:28 Uhr

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.
Parameter 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 viert Ganzzahl, Single-, oder Double-Fließkommawerten, je nach Typ des Evaluators. 2D-Kontrollpunkte werden in reihen-betonter 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