glGetMap: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Wird offline bearbeitet)
 
K (Kategorisierung, Wikisyntax für Parametertabelle)
 
(6 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Offline}}
+
= 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 ==
 +
{| border="1" rules="all"
 +
! ''target''
 +
| Ist der symbolische Name einer Karte. Akzeptiert werden:<br>
 +
'''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'''.
 +
|-
 +
! ''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]]
 +
 
 +
[[Kategorie:GL|GetMap]]
 +
[[Kategorie:GL1.0|GetMap]]

Aktuelle Version vom 21. Juli 2011, 12:25 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.

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