glGetMap: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(Version Hochgeladen)
K (Kategorisierung, Wikisyntax für Parametertabelle)
 
(5 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Unvollständig}}
 
 
= glGetMap =
 
= glGetMap =
  
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
'''glGetMap''' - liefert <b><i>evaluator parameters</i></b>.
+
'''glGetMap''' - liefert die Parameter der Evaluatoren (bedeutet zu Deutsch so viel wie ("Auswerten").
 +
 
 +
 
  
<br>
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
 
  procedure '''glGetMapdv'''(''target'': TGLenum; ''query'': TGLenum; ''v'': PGLdouble);
 
  procedure '''glGetMapdv'''(''target'': TGLenum; ''query'': TGLenum; ''v'': PGLdouble);
Zeile 12: Zeile 13:
 
  procedure '''glGetMapiv'''(''target'': TGLenum; ''query'': TGLenum; ''v'': PGLint);
 
  procedure '''glGetMapiv'''(''target'': TGLenum; ''query'': TGLenum; ''v'': PGLint);
  
<br>
+
 
 +
 
 
== 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>
 
  
<br>
 
  
 
== Beschreibung ==  
 
== Beschreibung ==  
'''glGetMap''' - liefert <b><i>evaluator parameters</i></b>. ('''glMap1''' und '''glMap2''' sind <b><i>parameters</i></b>.)
+
'''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 40: Zeile 39:
 
Dem Parameter ''query'' kan man folgende Werte zuweisen:
 
Dem Parameter ''query'' kan man folgende Werte zuweisen:
  
'''GL_COEFF'''
+
===GL_COEFF===
: ''v'' liefert die Stützstellen (control points) für die <b><i>evaluator function. One-dimensional evaluators return order control points, and two-dimensional evaluators return uorderxvorder control points. Each control point consists of one, two, three, or four integer, single-precision floating-point, or double-precision floating-point values, depending on the type of the evaluator. Two-dimensional control points are returned in row-major order, incrementing the uorder index quickly, and the vorder index after each row.</i></b>
+
: ''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.
  
'''GL_ORDER'''
+
===GL_ORDER===
: ''v'' liefert die <b><i>order of the evaluator function</i></b>.  
+
: ''v'' liefert den Rang der Evaluatoren-Funktion zurück.  
: Eindimensionale <b><i>evaluatoren</i></b> liefern einen einzelnen Wert, ''order''. Zweidimensionale <b><i>evaluators</i></b> liefern zwei Werte, ''uorder'' und ''vorder''.
+
: Eindimensionale Evaluatoren liefern einen einzelnen Wert, ''order''. Zweidimensionale Evaluatoren  liefern zwei Werte, ''uorder'' und ''vorder''.
  
'''GL_DOMAIN'''
+
===GL_DOMAIN===
 
: ''v'' liefert die linearen UV-Mapping Parameter, u und v.  
 
: ''v'' liefert die linearen UV-Mapping Parameter, u und v.  
: Eindimensionale <b><i>evaluators</i></b> 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 <b><i>evaluators</i></b> 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.
  
<br>
+
 
 +
 
 +
 
 
== Hinweise ==
 
== Hinweise ==
 
Wenn während der Ausführung der Funktion ein Fehler auftritt, wird der Inhalt von ''v'' nicht verändert.
 
Wenn während der Ausführung der Funktion ein Fehler auftritt, wird der Inhalt von ''v'' nicht verändert.
  
<br>
+
 
 +
 
 
== 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.
 +
 
 +
 
  
<br>
 
 
== Siehe auch ==
 
== Siehe auch ==
 
[[glEvalCoord]], [[glMap1]], [[glMap2]]  
 
[[glEvalCoord]], [[glMap1]], [[glMap2]]  
  
 
[[Kategorie:GL|GetMap]]
 
[[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