glMap2: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(Beschreibung)
K (Parameter)
 
(22 dazwischenliegende Versionen von 8 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Unvollständig}}
 
 
= glMap2 =
 
= glMap2 =
  
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
'''glMap2''' - definiert einen 2 demensionalen Bezieher
+
'''glMap2''' - definiert eine 2 dimensionale Bezierkurve (Beziergitter).
  
<br>
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
  
<pascal>procedure glMap2d(target: TGLenum; u1: TGLdouble; u2: TGLdouble; ustride: TGLint;  
+
<source lang="pascal">procedure glMap2d(target: TGLenum; u1: TGLdouble; u2: TGLdouble; ustride: TGLint;  
 
                   uorder: TGLint; v1: TGLdouble; v2: TGLdouble;  
 
                   uorder: TGLint; v1: TGLdouble; v2: TGLdouble;  
 
                   vstride: TGLint; vorder: TGLint; const points: PGLdouble);
 
                   vstride: TGLint; vorder: TGLint; const points: PGLdouble);
Zeile 15: Zeile 14:
 
procedure glMap2f(target: TGLenum; u1: TGLfloat; u2: TGLfloat; ustride: TGLint;
 
procedure glMap2f(target: TGLenum; u1: TGLfloat; u2: TGLfloat; ustride: TGLint;
 
                   uorder: TGLint; v1: TGLfloat;  v2: TGLfloat; vstride: TGLint;  
 
                   uorder: TGLint; v1: TGLfloat;  v2: TGLfloat; vstride: TGLint;  
                   vorder: TGLint; const points: PGLfloat);</pascal>
+
                   vorder: TGLint; const points: PGLfloat);</source>
 +
 
 +
 
  
<br>
 
  
 
== Parameter ==
 
== Parameter ==
Zeile 26: Zeile 26:
 
|-
 
|-
 
! ''u1, u2''  
 
! ''u1, u2''  
| '''''Specify a linear mapping of u, as presented to glEvalCoord2, to ^, one of the two variables that are evaluated by the equations specified by this command. Initially, u1 is 0 and u2 is 1.'''''
+
| Bestimmt das lineare Mapping von u (eine der beiden Variablen die durch [[glEvalCoord]]2 erstellt wird) zu u^. '''Vorgabewerte''' sind u1 = 0 und u2 = 1.
 
|-
 
|-
 
! ''ustride''  
 
! ''ustride''  
| '''''Specifies the number of floats or doubles between the beginning of control point R   and the beginning of control point R ij, where i and j are the u and v control pointiindices, respectively. This allows control points to be embedded in arbitrary data structures. The only constraint is that the values for a particular control point must occupy contiguous memory locations. The initial value of ustride is 0.'''''
+
| Legt die Anzahl float- oder double-Werte fest die zwischen dem Kontrollpunkt R(i,j) und dem Kontrollpunkt R(i+1,j) liegen. Wobei i und j für die u bzw. v Kontrollpunktindizes stehen. Dies erlaubt es Kontrollpunkte in beliebige Datenstrukturen einzubetten. Die einzige Einschränkung die gemacht werden muss ist, dass die Werte eines Kontrollpunktes direkt hintereinander im Speicher liegen müssen. Der '''Vorgabewert''' ist '''0'''.
 
|-
 
|-
 
! ''uorder''  
 
! ''uorder''  
| '''''Specifies the dimension of the control point array in the u axis. Must be positive. The initial value is 1.'''''
+
| Legt die Dimension des Kontrollpunktfeldes in u-Richtung fest. Muss ein positiver Wert sein. '''Vorgabe''' ist '''1'''.
 
|-
 
|-
 
! ''v1, v2''  
 
! ''v1, v2''  
| '''''Specify a linear mapping of v, as presented to glEvalCoord2, to ^, one of the two variables that are evaluated by the equations specified by this command. Initially, v1 is 0 and v2 is 1.'''''
+
| Bestimmt das lineare Mapping von v (eine der beiden Variablen die durch [[glEvalCoord]]2 erstellt wird) zu v^. '''Vorgabewerte''' sind v1 = 0 und v2 = 1.
 
|-
 
|-
 
! ''vstride''  
 
! ''vstride''  
| '''''Specifies the number of floats or doubles between the beginning of control point R and the beginning of control point R ij, where i and j are the u and v control point(indices, respectively. This allows control points to be embedded in arbitrary data structures. The only constraint is that the values for a particular control point must occupy contiguous memory locations. The initial value of vstride is 0.'''''
+
| Legt die Anzahl float- oder double-Werte fest die zwischen dem Kontrollpunkt R(i,j) und dem Kontrollpunkt R(i,j+1) liegen. Wobei i und j für die u bzw. v Kontrollpunktindizes stehen. Dies erlaubt es Kontrollpunkte in beliebige Datenstrukturen einzubetten. Die einzige Einschränkung die gemacht werden muss ist, dass die Werte eines Kontrollpunktes direkt hintereinander im Speicher liegen müssen. Der '''Vorgabewert''' ist '''0'''.
 
|-
 
|-
 
! ''vorder''  
 
! ''vorder''  
| '''''Specifies the dimension of the control point array in the v axis. Must be positive. The initial value is 1.'''''
+
| Legt die Dimension des Kontrollpunktfeldes in v-Richtung fest. Muss ein positiver Wert sein. '''Vorgabe''' ist '''1'''.
 
|-
 
|-
 
! ''points''  
 
! ''points''  
| Ein Zeiger auf den Kontrollpunkt Array.
+
| Ein Zeiger auf das Kontrollpunkt Array.
 
|}
 
|}
 
<br>
 
  
 
== Beschreibung ==  
 
== Beschreibung ==  
 +
2D-Evaluatoren (Bezier-Gitter) unterstützen einen Weg um mittels polinomialen und rational polinomialen Mapping Vertices, Normalen, Textur-Koordinaten und Farben zu erzeugen. Die von den Evaluatoren stammenden Werte, werden zu weiteren OpenGL Verarbeitungsstufen gesendet, als ob sie von [[glVertex]], [[glNormal]], [[glTexCoord]] und [[glColor]] Befehlen kommen würden. Der einzige Unterschied besteht darin das die aktuelle [[Normale]], Texturkoordinate oder Farbe nicht verändert wird.
  
Bezieher unterstützen einen Weg um mit ganzrationalen Funktionen Vertexe, Normalen, Textur-Koordinaten und Farben zu erzeugen. Die von den Evelatoren stammenden Werte, werden zu weitern OpenGL Verarbeitungs stufen gesendet, als ob sie von [[glVertex]], [[glNormal]], [[glTexCoord]] und [[glColor]] Befehlen kommen würden. Der einzigste Unterschied besteht darin das die aktuelle Normale, Texturkoordinate oder Farbe nicht verändert wird.
+
[http://de.wikipedia.org/wiki/Splines Splines](Teilbereiche von Polynomen) von beliebigen Grades(bis zu dem maximalen Grad den die OpenGL Inmplementation unterstützt) können mit Evaluatoren beschrieben werden. Dies beinhaltet fast sämtliche Oberflächentypen die in der Computergrafik verwendet werden, inklusive B-spline Oberflächen, [[NURBS]] Oberflächen, Bezier Oberflächen und so weiter.  
 
 
[http://de.wikipedia.org/wiki/Splines Spline](Teilbereiche von Polynomen) von beliebigen Grades(bis zu dem maximalen Grad den die OpenGL Inmplementation unterstützt) können mit Evaluatoren beschrieben werden. Dies beinhalet fast sämtliche Oberflächen die von Computer Grafiken verwendet werden, inklusive B-spline Oberflächen, NURBS Oberflächen, Bezieher Oberflächen und so weiter.  
 
  
 
Von Evaluatoren definierte Oberflächen basieren auf bivariaten [http://de.wikipedia.org/wiki/Bernsteinpolynom Bernsteinpolynom].
 
Von Evaluatoren definierte Oberflächen basieren auf bivariaten [http://de.wikipedia.org/wiki/Bernsteinpolynom Bernsteinpolynom].
  
 
Definiere  
 
Definiere  
[[Bild:glMap2_EvaluatorDefinition.png]]  
+
[[Bild:GlMap2_EvaluatorDefinition.png]]  
  
[[Bild:glMap12_BernsteinPolynomU.png]] ist das '''i'''te Bernsteinpolynom vom Grad '''n''' (''uorder''= '''n'''+1)
+
[[Bild:GlMap12_BernsteinPolynomU.png]] ist das '''i'''te Bernsteinpolynom vom Grad '''n''' (''uorder''= '''n'''+1)
  
und [[Bild:glMap2_BernsteinPolynomV.png]] ist das '''j'''te Bernsteinpolynom vom Grad '''m''' (''vorder'' = '''m'''+1).
+
und [[Bild:GlMap2_BernsteinPolynomV.png]] ist das '''j'''te Bernsteinpolynom vom Grad '''m''' (''vorder'' = '''m'''+1).
  
 
Nocheinmal zur Erinnerung:
 
Nocheinmal zur Erinnerung:
[[Bild:glMap12_BinomEigenschaften.png]]
+
[[Bild:GlMap12_BinomEigenschaften.png]]
 +
 
 +
'''glMap2''' wird benutzt um die Basis zu definieren und festzulegen, welche Werte erzeugt werden sollen. Einmal definiert, kann eine Map mit [[glEnable|glEnable/glDisable]] und dem Map-Namen (einer der 9 nachfolgend gelisteten Werte) aktiviert und deaktiviert werden. Wenn [[glEvalCoord]]2 '''u''' und '''v''' liefert wird das bivariante Bernsteinpolynom ausgewertet indem u^ und v^ dach verwendet werden wobei
 +
 
 +
[[Bild:GlMap12_u.png]] und
 +
[[Bild:GlMap2_v.png]] ist.
 +
 
 +
''target'' ist eine symbolische Konstante die anzeigt, welcher Typ für die Kontrollpunkte in Points verwendet wird und welche Ausgabe generiert wird, wenn die Karte/Map ausgewertet wird. ''target'' kann einen der nachfolgenden Werte annehmen:
  
  glMap2 is used to define the basis and to specify what kind
+
'''GL_MAP2_VERTEX_3'''  
  of values are produced. Once defined, a map can be enabled
+
: Jeder Kontrollpunkt besteht aus drei Fließkommawerten welche die x,y und z-Komponente darstellen. Intern werden [[glVertex]]3x Befehle generiert wenn die Map ausgewertet wird.
  and disabled by calling glEnable and glDisable with the map
 
  name, one of the nine predefined values for target,
 
  described below. When glEvalCoord2 presents values u and v,
 
  the bivariate Bernstein polynomials are evaluated using ^
 
  and ^, where
 
  
[[Bild:glMap12_u.png]] and
+
'''GL_MAP2_VERTEX_4'''
[[Bild:glMap2_v.png]]
+
: Jeder Kontrollpunkt besteht aus vier Fließkommawerten welche die x,y,z und w-Komponente darstellen. Intern werden [[glVertex]]4x Befehle generiert wenn die Map ausgewertet wird.
  
  target is a symbolic constant that indicates what kind of
+
'''GL_MAP2_INDEX'''
  control points are provided in points, and what output is
+
: Jeder Kontrollpunkt ist ein einzelner Fließkommawert welcher einen Farbindex darstellt. Intern werden [[glIndex]] Befehle generiert wenn die Map ausgewertet wird. Der aktuelle Index wird aber nicht mit den generierten Werten überschrieben.
  generated when the map is evaluated. It can assume one of
 
  nine predefined values:
 
  
  GL_MAP2_VERTEX_3   Each control point is three
+
'''GL_MAP2_COLOR_4'''    
  floating-point values representing
+
: Jeder Kontrollpunkt besteht aus vier Fließkommawerten welche die r,g,b und a-Farbkomponenten darstellen. Intern werden [[glColor]]4x Befehle generiert wenn die Map ausgewertet wird. Die aktuelle Farbe wird aber nicht mit der generierten Farbe überschrieben.  
  x, y, and z. Internal glVertex3
 
  commands are generated when the map
 
  is evaluated.
 
  
  GL_MAP2_VERTEX_4   Each control point is four
+
'''GL_MAP2_NORMAL'''
  floating-point values representing
+
: Jeder Kontrollpunkt besteht aus drei Fließkommawerten welche die x,y und z-Komponente darstellen. Intern werden [[glNormal]] Befehle generiert wenn die Map ausgewertet wird. Die aktuelle Normale wird aber nicht mit den generierten Normalen überschrieben.  
  x, y, z, and w. Internal glVertex4
 
  commands are generated when the map
 
  is evaluated.
 
  
  GL_MAP2_INDEX   Each control point is a single
+
'''GL_MAP2_TEXTURE_COORD_1'''
  floating-point value representing a
+
: Jeder Kontrollpunkt ist ein einzelner Fließkommawert welcher die s-Texturkoordinate darstellt. Intern werden [[glTexCoord]]1 Befehle generiert wenn die Map ausgewertet wird. Die aktuelle Texturcoordinate wird aber nicht mit den generierten Werten überschrieben.
  color index. Internal glIndex
 
  commands are generated when the map
 
  is evaluated but the current index
 
  is not updated with the value of
 
  these glIndex commands.
 
  
  GL_MAP2_COLOR_4   Each control point is four
+
'''GL_MAP2_TEXTURE_COORD_2''' 
  floating-point values representing
+
: Jeder Kontrollpunkt besteht aus zwei Fließkommawerten welche die s und t-Texturkoordinate darstellen. Intern werden [[glTexCoord]]2 Befehle generiert wenn die Map ausgewertet wird. Die aktuellen Texturcoordinate werden aber nicht mit den generierten Werten überschrieben.  
  red, green, blue, and alpha.
 
  Internal glColor4 commands are
 
  generated when the map is evaluated
 
  but the current color is not
 
  updated with the value of these
 
  glColor4 commands.
 
  
  GL_MAP2_NORMAL   Each control point is three
+
'''GL_MAP2_TEXTURE_COORD_3'''
  floating-point values representing
+
: Jeder Kontrollpunkt besteht aus drei Fließkommawerten welche die s,t und r-Texturkoordinate darstellen. Intern werden [[glTexCoord]]3 Befehle generiert wenn die Map ausgewertet wird. Die aktuellen Texturcoordinate werden aber nicht mit den generierten Werten überschrieben.  
  the x, y, and z components of a
 
  normal vector. Internal glNormal
 
  commands are generated when the map
 
  is evaluated but the current normal
 
  is not updated with the value of
 
  these glNormal commands.
 
  
  GL_MAP2_TEXTURE_COORD_1 Each control point is a single
+
'''GL_MAP2_TEXTURE_COORD_4'''  
  floating-point value representing
+
: Jeder Kontrollpunkt besteht aus vier Fließkommawerten welche die s,t,r und q-Texturkoordinate darstellen. Intern werden [[glTexCoord]]4 Befehle generiert wenn die Map ausgewertet wird. Die aktuellen Texturcoordinate werden aber nicht mit den generierten Werten überschrieben.  
  the s texture coordinate. Internal
 
  glTexCoord1 commands are generated
 
  when the map is evaluated but the
 
  current texture coordinates are not
 
  updated with the value of these
 
  glTexCoord commands.
 
  
  GL_MAP2_TEXTURE_COORD_2  Each control point is two
+
''ustride, uorder, vstride, vorder,'' und ''points'' werden benutzt um auf das Feld mit den Kontrollpunkten zugreifen zu können.
  floating-point values representing
 
  the s and t texture coordinates.
 
  Internal
 
  glTexCoord2 commands are generated
 
  when the map is evaluated but the
 
  current texture coordinates are not
 
  updated with the value of these
 
  glTexCoord commands.
 
  
  GL_MAP2_TEXTURE_COORD_3  Each control point is three
+
''points'' ist ein Zeiger auf den ersten Kontrollpunkt im Feld, welcher, abhängig vom Typ, eine bis vier aufeinanderfolgende Speichereinheiten belegen kann.  
  floating-point values representing
 
  the s, t, and r texture
 
  coordinates. Internal glTexCoord3
 
  commands are generated when the map
 
  is evaluated but the current
 
  texture coordinates are not updated
 
  with the value of these glTexCoord
 
  commands.
 
  
  GL_MAP2_TEXTURE_COORD_4  Each control point is four
+
Es liegen ''uorder'' * ''vorder'' Kontrollpunkte im Feld.  
  floating-point values representing
 
  the s, t, r, and q texture
 
  coordinates. Internal
 
  glTexCoord4 commands are generated
 
  when the map is evaluated but the
 
  current texture coordinates are not
 
  updated with the value of these
 
  glTexCoord commands.
 
  
  ustride, uorder, vstride, vorder, and points define the
+
''ustride'' bestimmt wieviele float oder double Werte zwischen den Kontrollpunkten einer Zeile übersprungen werden müssen um zum nachfolgenden Kontrollpunkt in der Zeile zu kommen ( Rij -> R(i+1)j ).
  array addressing for accessing the control points.  points
 
  is the location of the first control point, which occupies
 
  one, two, three, or four contiguous memory locations,
 
  depending on which map is being defined.  There are
 
  uorderxvorder control points in the array.  ustride
 
  specifies how many float or double locations are skipped to
 
  advance the internal memory pointer from control point R
 
  to control point R   .  vstride specifies how many float
 
  or double locationsiarejskipped to advance the internal
 
  memory pointer from control point R to control point
 
  R .     ij
 
  i(j+1)
 
'''''
 
  
<br>
+
''vstride'' bestimmt wieviele float oder double Werte zwischen den Kontrollpunkten einer Spalte übersprungen werden müssen um zum nachfolgenden Kontrollpunkt in der Spalte zu kommen ( Rij -> Ri(j+1) ).
  
 
== Hinweise ==
 
== Hinweise ==
'''''
+
Wie bei allen GL Befehlen die Zeiger benutzen, verhält sich das Feld ''points'' so, als ob der Inhalt des Feldes durch '''Map2''' kopiert worden wäre bevor '''Map2''' beendet wurde. Änderungen am Inhalt von ''points'' haben damit keinen Effekt nachdem '''glMap2''' ausgeführt wurde.
  As is the case with all GL commands that accept pointers to
+
 
  data, it is as if the contents of points were copied by
+
Nach der Initialisierung ist '''GL_AUTO_NORMAL''' aktiviert. Wenn '''GL_AUTO_NORMAL''' aktiviert ist, werden Normalenvektoren erstellt wenn entweder '''GL_MAP2_VERTEX_3''' oder '''GL_MAP_VERTEX_4''' benutzt wird um Vertices zu generieren.
  glMap2 before glMap2 returns. Changes to the contents of
+
 
  points have no effect after glMap2 is called.
+
 
  
  Initially, GL_AUTO_NORMAL is enabled. If GL_AUTO_NORMAL is
 
  enabled, normal vectors are generated when either
 
  GL_MAP2_VERTEX_3 or GL_MAP2_VERTEX_4 is used to generate
 
  vertices.
 
'''''
 
  
<br>
 
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
 
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' nicht akzeptiert wird<br>
 
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' nicht akzeptiert wird<br>
Zeile 198: Zeile 123:
 
'''GL_INVALID_OPERATION''' wird generiert wenn glMap2 innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.  
 
'''GL_INVALID_OPERATION''' wird generiert wenn glMap2 innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.  
  
<br>
+
 
 +
 
  
 
==  Zugehörige Wertrückgaben ==
 
==  Zugehörige Wertrückgaben ==
Zeile 214: Zeile 140:
  
  
<br>
+
 
 +
 
  
 
== Siehe auch ==
 
== Siehe auch ==
Zeile 220: Zeile 147:
  
 
[[Kategorie:GL|Map2]]
 
[[Kategorie:GL|Map2]]
 +
[[Kategorie:GL1.0]]

Aktuelle Version vom 21. Juni 2009, 06:40 Uhr

glMap2

Name

glMap2 - definiert eine 2 dimensionale Bezierkurve (Beziergitter).

Delphi-Spezifikation

procedure glMap2d(target: TGLenum; u1: TGLdouble; u2: TGLdouble; ustride: TGLint; 
                  uorder: TGLint; v1: TGLdouble; v2: TGLdouble; 
                  vstride: TGLint; vorder: TGLint; const points: PGLdouble);

procedure glMap2f(target: TGLenum; u1: TGLfloat; u2: TGLfloat; ustride: TGLint;
                  uorder: TGLint; v1: TGLfloat;  v2: TGLfloat; vstride: TGLint; 
                  vorder: TGLint; const points: PGLfloat);



Parameter

target Bestimmt den Typ der Werte die generiert werden sollen. Folgende symbolsiche Konstanden werden akzeptiert: GL_MAP2_VERTEX_3, GL_MAP2_VERTEX_4, GL_MAP2_INDEX, GL_MAP2_COLOR_4, GL_MAP2_NORMAL, GL_MAP2_TEXTURE_COORD_1, GL_MAP2_TEXTURE_COORD_2, GL_MAP2_TEXTURE_COORD_3, und GL_MAP2_TEXTURE_COORD_4
u1, u2 Bestimmt das lineare Mapping von u (eine der beiden Variablen die durch glEvalCoord2 erstellt wird) zu u^. Vorgabewerte sind u1 = 0 und u2 = 1.
ustride Legt die Anzahl float- oder double-Werte fest die zwischen dem Kontrollpunkt R(i,j) und dem Kontrollpunkt R(i+1,j) liegen. Wobei i und j für die u bzw. v Kontrollpunktindizes stehen. Dies erlaubt es Kontrollpunkte in beliebige Datenstrukturen einzubetten. Die einzige Einschränkung die gemacht werden muss ist, dass die Werte eines Kontrollpunktes direkt hintereinander im Speicher liegen müssen. Der Vorgabewert ist 0.
uorder Legt die Dimension des Kontrollpunktfeldes in u-Richtung fest. Muss ein positiver Wert sein. Vorgabe ist 1.
v1, v2 Bestimmt das lineare Mapping von v (eine der beiden Variablen die durch glEvalCoord2 erstellt wird) zu v^. Vorgabewerte sind v1 = 0 und v2 = 1.
vstride Legt die Anzahl float- oder double-Werte fest die zwischen dem Kontrollpunkt R(i,j) und dem Kontrollpunkt R(i,j+1) liegen. Wobei i und j für die u bzw. v Kontrollpunktindizes stehen. Dies erlaubt es Kontrollpunkte in beliebige Datenstrukturen einzubetten. Die einzige Einschränkung die gemacht werden muss ist, dass die Werte eines Kontrollpunktes direkt hintereinander im Speicher liegen müssen. Der Vorgabewert ist 0.
vorder Legt die Dimension des Kontrollpunktfeldes in v-Richtung fest. Muss ein positiver Wert sein. Vorgabe ist 1.
points Ein Zeiger auf das Kontrollpunkt Array.

Beschreibung

2D-Evaluatoren (Bezier-Gitter) unterstützen einen Weg um mittels polinomialen und rational polinomialen Mapping Vertices, Normalen, Textur-Koordinaten und Farben zu erzeugen. Die von den Evaluatoren stammenden Werte, werden zu weiteren OpenGL Verarbeitungsstufen gesendet, als ob sie von glVertex, glNormal, glTexCoord und glColor Befehlen kommen würden. Der einzige Unterschied besteht darin das die aktuelle Normale, Texturkoordinate oder Farbe nicht verändert wird.

Splines(Teilbereiche von Polynomen) von beliebigen Grades(bis zu dem maximalen Grad den die OpenGL Inmplementation unterstützt) können mit Evaluatoren beschrieben werden. Dies beinhaltet fast sämtliche Oberflächentypen die in der Computergrafik verwendet werden, inklusive B-spline Oberflächen, NURBS Oberflächen, Bezier Oberflächen und so weiter.

Von Evaluatoren definierte Oberflächen basieren auf bivariaten Bernsteinpolynom.

Definiere GlMap2 EvaluatorDefinition.png

GlMap12 BernsteinPolynomU.png ist das ite Bernsteinpolynom vom Grad n (uorder= n+1)

und GlMap2 BernsteinPolynomV.png ist das jte Bernsteinpolynom vom Grad m (vorder = m+1).

Nocheinmal zur Erinnerung: GlMap12 BinomEigenschaften.png

glMap2 wird benutzt um die Basis zu definieren und festzulegen, welche Werte erzeugt werden sollen. Einmal definiert, kann eine Map mit glEnable/glDisable und dem Map-Namen (einer der 9 nachfolgend gelisteten Werte) aktiviert und deaktiviert werden. Wenn glEvalCoord2 u und v liefert wird das bivariante Bernsteinpolynom ausgewertet indem u^ und v^ dach verwendet werden wobei

GlMap12 u.png und GlMap2 v.png ist.

target ist eine symbolische Konstante die anzeigt, welcher Typ für die Kontrollpunkte in Points verwendet wird und welche Ausgabe generiert wird, wenn die Karte/Map ausgewertet wird. target kann einen der nachfolgenden Werte annehmen:

GL_MAP2_VERTEX_3

Jeder Kontrollpunkt besteht aus drei Fließkommawerten welche die x,y und z-Komponente darstellen. Intern werden glVertex3x Befehle generiert wenn die Map ausgewertet wird.

GL_MAP2_VERTEX_4

Jeder Kontrollpunkt besteht aus vier Fließkommawerten welche die x,y,z und w-Komponente darstellen. Intern werden glVertex4x Befehle generiert wenn die Map ausgewertet wird.

GL_MAP2_INDEX

Jeder Kontrollpunkt ist ein einzelner Fließkommawert welcher einen Farbindex darstellt. Intern werden glIndex Befehle generiert wenn die Map ausgewertet wird. Der aktuelle Index wird aber nicht mit den generierten Werten überschrieben.

GL_MAP2_COLOR_4

Jeder Kontrollpunkt besteht aus vier Fließkommawerten welche die r,g,b und a-Farbkomponenten darstellen. Intern werden glColor4x Befehle generiert wenn die Map ausgewertet wird. Die aktuelle Farbe wird aber nicht mit der generierten Farbe überschrieben.

GL_MAP2_NORMAL

Jeder Kontrollpunkt besteht aus drei Fließkommawerten welche die x,y und z-Komponente darstellen. Intern werden glNormal Befehle generiert wenn die Map ausgewertet wird. Die aktuelle Normale wird aber nicht mit den generierten Normalen überschrieben.

GL_MAP2_TEXTURE_COORD_1

Jeder Kontrollpunkt ist ein einzelner Fließkommawert welcher die s-Texturkoordinate darstellt. Intern werden glTexCoord1 Befehle generiert wenn die Map ausgewertet wird. Die aktuelle Texturcoordinate wird aber nicht mit den generierten Werten überschrieben.

GL_MAP2_TEXTURE_COORD_2

Jeder Kontrollpunkt besteht aus zwei Fließkommawerten welche die s und t-Texturkoordinate darstellen. Intern werden glTexCoord2 Befehle generiert wenn die Map ausgewertet wird. Die aktuellen Texturcoordinate werden aber nicht mit den generierten Werten überschrieben.

GL_MAP2_TEXTURE_COORD_3

Jeder Kontrollpunkt besteht aus drei Fließkommawerten welche die s,t und r-Texturkoordinate darstellen. Intern werden glTexCoord3 Befehle generiert wenn die Map ausgewertet wird. Die aktuellen Texturcoordinate werden aber nicht mit den generierten Werten überschrieben.

GL_MAP2_TEXTURE_COORD_4

Jeder Kontrollpunkt besteht aus vier Fließkommawerten welche die s,t,r und q-Texturkoordinate darstellen. Intern werden glTexCoord4 Befehle generiert wenn die Map ausgewertet wird. Die aktuellen Texturcoordinate werden aber nicht mit den generierten Werten überschrieben.

ustride, uorder, vstride, vorder, und points werden benutzt um auf das Feld mit den Kontrollpunkten zugreifen zu können.

points ist ein Zeiger auf den ersten Kontrollpunkt im Feld, welcher, abhängig vom Typ, eine bis vier aufeinanderfolgende Speichereinheiten belegen kann.

Es liegen uorder * vorder Kontrollpunkte im Feld.

ustride bestimmt wieviele float oder double Werte zwischen den Kontrollpunkten einer Zeile übersprungen werden müssen um zum nachfolgenden Kontrollpunkt in der Zeile zu kommen ( Rij -> R(i+1)j ).

vstride bestimmt wieviele float oder double Werte zwischen den Kontrollpunkten einer Spalte übersprungen werden müssen um zum nachfolgenden Kontrollpunkt in der Spalte zu kommen ( Rij -> Ri(j+1) ).

Hinweise

Wie bei allen GL Befehlen die Zeiger benutzen, verhält sich das Feld points so, als ob der Inhalt des Feldes durch Map2 kopiert worden wäre bevor Map2 beendet wurde. Änderungen am Inhalt von points haben damit keinen Effekt nachdem glMap2 ausgeführt wurde.

Nach der Initialisierung ist GL_AUTO_NORMAL aktiviert. Wenn GL_AUTO_NORMAL aktiviert ist, werden Normalenvektoren erstellt wenn entweder GL_MAP2_VERTEX_3 oder GL_MAP_VERTEX_4 benutzt wird um Vertices zu generieren.



Fehlermeldungen

GL_INVALID_ENUM wird generiert wenn target nicht akzeptiert wird
GL_INVALID_VALUE wird geniert wenn u1 = u2 ist oder wenn v1 = v2 ist.
GL_INVALID_VALUE wird geniert wenn ustride oder vstride kleiner ist als die anzahl der Kontrollpunkte
GL_INVALID_VALUE wird geniert wenn ustride oder vstride kleiner als 1 oder größer als GL_MAX_EVAL_ORDER ist.
GL_INVALID_OPERATION wird generiert wenn glMap2 innerhalb eines glBegin-glEnd Blocks aufgerufen wird.



Zugehörige Wertrückgaben



Siehe auch

glBegin, glColor, glEnable, glEvalCoord, glEvalMesh, glEvalPoint, glMap1, glMapGrid, glNormal, glTexCoord, glVertex