glEvalMesh: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(Parameter: Formulierung verbessert)
K ()
Zeile 26: Zeile 26:
  
 
== Beschreibung ==
 
== Beschreibung ==
[[glMapGrid]] und '''glEvalMesh''' werden gemeinsam genutzt um auf effiziente Art und Weise eine Serie von gleichmäßig verteilten Karten-Gebiets-Werten (engl.: map domain values) zu erstellen und auszuwerten.
 
  
'''glEvalMesh''' läuft durch den Integer-Bereich eines ein- oder zweidimensionalen Gitters, dessen Ausdehnung das Gebiet der Auswertungskarten ist, die durch [[glMap1]] und [[glMap2]] festgelegt wurden.  
+
'''glEvalMesh''' und [[glMapGrid]] werden gemeinsam genutzt, um auf effiziente Art und Weise Bézierkurven oder -flächen zu berechnen und zu rendern.
 +
 
 +
Nachdem mit [[glMap1]] oder [[glMap2]] die Kontrollpunkte einer Bézierkurve oder -fläche festgelegt wurden, errechnet [[glMapGrid]] daraus ein ein- oder zweidimensionales Punkte-Gitter mit gleichmäßig verteilten Punkten, welches danach mit '''glEvalMesh''' gezeichnet werden kann.
  
 
''mode'' bestimmt wie die entstehenden Punkte verbunden werden sollen. Entweder werden sie als Punkte dargestellt, zu Linien verbunden oder zu einem Polygon gemacht (indem die Linien gefüllt werden).  
 
''mode'' bestimmt wie die entstehenden Punkte verbunden werden sollen. Entweder werden sie als Punkte dargestellt, zu Linien verbunden oder zu einem Polygon gemacht (indem die Linien gefüllt werden).  
Zeile 91: Zeile 92:
  
 
<br>
 
<br>
 +
 
== Hinweise ==
 
== Hinweise ==
 
Bitte beachten Sie die angesprochenen Bedingungen für die Fälle ''i=n'' bzw. ''j=m''.
 
Bitte beachten Sie die angesprochenen Bedingungen für die Fälle ''i=n'' bzw. ''j=m''.

Version vom 27. Mai 2005, 11:53 Uhr

glEvalMesh


Name

glEvalMesh1, glEvalMesh2 - Zeichnet eine Evaluator Kurve (1D) oder ein Gitter (2D).

Delphi-Spezifikation

procedure glEvalMesh1(mode: TGLenum; i1: TGLint; i2: TGLint); 
procedure glEvalMesh2(mode: TGLenum; i1: TGLint; i2: TGLint; j1: TGLint; j2: TGLint);


Parameter

mode Für glEvalMesh1: Legt fest ob die Evaluator Kurve eine Linie ist, oder nur aus einzelnen Punkten besteht. Akzeptierte symbolische Konstanten sind: GL_POINT und GL_LINE.

Für glEvalMesh2: Bestimmt ob zweidimensionales Netz von Punkten, Linen oder Polygonen erstellt werden soll. Akzeptierte symbolische Konstanten sind: GL_POINT, GL_LINE und GL_FILL

i1, i2,
j1, j2
i1, i2 legt fest bei welchem Vertex, der von glMapGrid1 generierten Vertex-Reihe, die Kurve beginnt und bei welchem sie aufhört. Bei einem Gitter (glMapGrid2) werden alle Vertizes die in dem von Vertex (i1/j1) und (i2/j2) begrenzten Rechteck liegen gezeichnet.


Beschreibung

glEvalMesh und glMapGrid werden gemeinsam genutzt, um auf effiziente Art und Weise Bézierkurven oder -flächen zu berechnen und zu rendern.

Nachdem mit glMap1 oder glMap2 die Kontrollpunkte einer Bézierkurve oder -fläche festgelegt wurden, errechnet glMapGrid daraus ein ein- oder zweidimensionales Punkte-Gitter mit gleichmäßig verteilten Punkten, welches danach mit glEvalMesh gezeichnet werden kann.

mode bestimmt wie die entstehenden Punkte verbunden werden sollen. Entweder werden sie als Punkte dargestellt, zu Linien verbunden oder zu einem Polygon gemacht (indem die Linien gefüllt werden).

Im eindimensionales Fall, glEvalMesh1, wird das Netz auf die gleiche Art erstellt, als wie wenn der nachfolgende Code ausgeführt werden würde:

glBegin(EIN_GL_TYPE);
for i := i1 to i2 do
    glEvalCoord1( i*du +u1);
glEnd;

wobei

du=(u2-u1)/n

ist und n, u1 sowie u2 die Argumente des aller letzten glMapGrid1 Befehle sind. EIN_GL_TYPE ist GL_POINTS wenn mode GL_POINT ist, oder GL_LINES falls mode GL_LINE ist.

Eine absolut wichtige Bedingung ist, dass bei i=n der berechnete Wert i*du + u1 genau dem Wert u2 entsprechen muss!


Für den zweidimensionalen Fall, glEvalMesh2 gilt

du = (u2-u1)/n
dv = (v2-v1)/m

wobei n, u1, u2, m, v1, v2 die Argumente des aller letzten glMapGrid2 Befehls sind. Wenn dann mode GL_FILL ist, entspricht der Aufruf von glEvalMesh dem folgenden Code:

for j := j1 to j2 do
begin
  glBegin(GL_QUAD_STRIP);
  for i := i1 to i2 do
  begin
    glEvalCoord2( i*du +u1, j*dv +v1 );
    glEvalCoord2( i*du +u1, (j+1)*dv +v1 );
  end;
  glEnd;
end; 

Wenn mode gleich GL_LINE ist dann entspricht der Aufruf von glEvalMesh2 dem folgenden Code:

for j := j1 to j2 do
begin
  glBegin(GL_LINE_STRIP);
  for i := i1 to i2 do
      glEvalCoord2( i*du +u1, j*dv +v1 );
  glEnd;
end; 
for i := i1 to i2 do
begin
  glBegin(GL_LINE_STRIP);
  for j := j1 to j2 do
      glEvalCoord2( i*du +u1, j*dv +v1 );
  glEnd;
end; 

Wenn mode gleich GL_POINT ist dann entspricht der Aufruf von glEvalMesh2 dem folgenden Code:

glBegin(GL_POINTS);
for j := j1 to j2 do
  for i := i1 to i2 do
      glEvalCoord2( i*du +u1, j*dv +v1 );
glEnd;

In allen drei Fällen ist es unbedingt notwendig, dass für i=n gelten muss, dass der berechneten Wert i*du +u1 exakt u2 und für j=m der berechnete Wert j*dv +v1 exakt v2 sein muss!


Hinweise

Bitte beachten Sie die angesprochenen Bedingungen für die Fälle i=n bzw. j=m.


Fehlermeldungen

GL_INVALID_ENUM wird generiert wenn mode einen ungültigen Wert besitzt.
GL_INVALID_OPERATION wird generiert wenn FUNCTIONNAME innerhalb eines glBegin-glEnd Blocks aufgerufen wird.


Zugehörige Wertrückgaben

glGet mit Token GL_MAP1_GRID_DOMAIN
glGet mit Token GL_MAP2_GRID_DOMAIN
glGet mit Token GL_MAP1_GRID_SEGMENTS
glGet mit Token GL_MAP2_GRID_SEGMENTS


Siehe auch

glBegin, glEvalCoord, glEvalPoint, glMap1, glMap2, glMapGrid

Links