glGetMap: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(Siehe auch)
K (Kategorisierung, Wikisyntax für Parametertabelle)
 
Zeile 16: Zeile 16:
  
 
== Parameter ==
 
== Parameter ==
<table border=1 rules=all>
+
{| border="1" rules="all"
<tr>
+
! ''target''
<td>''target''</td>
+
| Ist der symbolische Name einer Karte. Akzeptiert werden:<br>
<td>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'''.
'''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'''.</td>
+
|-
</tr>
+
! ''query''
<tr>
+
| Bestimmt welche Parameter zurückgeliefert werden sollen. Als symbolische Namen werden '''GL_COEFF, GL_ORDER,''' und '''GL_DOMAIN''' akzeptiert.
<td>''Parameter''</td>
+
|-
<td>Bestimmt welche Parameter zurückgeliefert werden sollen. Als symbolische Namen werden '''GL_COEFF, GL_ORDER,''' und '''GL_DOMAIN''' akzeptiert.</td>
+
! ''v''
</tr>
+
| Ist ein Zeiger auf die abgefragten Daten.
<tr>
+
|}
<td>''v''</td>
 
<td>Ist ein Zeiger auf die abgefragten Daten.</td>
 
</tr>
 
</table>
 
  
  
Zeile 36: Zeile 32:
  
 
== Beschreibung ==  
 
== Beschreibung ==  
'''glGetMap''' - liefert die Evaluatoren Parameter. ('''glMap1''' und '''glMap2''' sind Parameter.)
+
'''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.
 
''target'' selektiert eine Karte, ''query'' bestimmt die abzufragende Eigenschaft und ''v'' zeigt auf den Speicherbereich, in den die Ergebnisse der Abfrage abgelegt werden sollen.
  
Zeile 44: Zeile 40:
  
 
===GL_COEFF===
 
===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.
+
: ''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.
 
: Ganzzahlen werden, wenn abgefragt, bestimmt durch Runden der internen Fließkommarepräsentation zur nächsten Ganzzahl.
  
Zeile 54: Zeile 50:
 
: ''v'' liefert die linearen UV-Mapping Parameter, u und v.  
 
: ''v'' liefert die linearen UV-Mapping Parameter, u und v.  
 
: Eindimensionale Evaluatoren liefern zwei Werte, ''u1'' und ''u2'', entsprechend der Definition durch [[glMap1]].
 
: 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.
+
: 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.
 
: Ganzzahlen werden, wenn abgefragt, bestimmt durch Runden der internen Fließkommarepräsentation zur nächsten Ganzzahl.
  
Zeile 66: Zeile 62:
  
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
'''GL_INVALID_ENUM''' wird generiert wenn entweder ''target'' oder ''query'' ein ungültiger Wert übergeben wird.<br>
+
'''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.
+
 
 +
'''GL_INVALID_OPERATION''' wird generiert, wenn '''glGetMap''' innerhalb eines [[glBegin]]-[[glEnd]]-Blocks aufgerufen wird.
  
  
Zeile 75: Zeile 72:
  
 
[[Kategorie:GL|GetMap]]
 
[[Kategorie:GL|GetMap]]
[[Kategorie:GL1.0]]
+
[[Kategorie:GL1.0|GetMap]]

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