Version vom 22. Mai 2005, 19:45 Uhr

glEvalMesh

Name

glEvalMesh1, glEvalMesh2 - Berechnen ein ein- oder zweidimensionales Punkt- oder Liniengitter.

Delphi-Spezifikation

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

Parameter

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.

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

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

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

• DGL Tutorial: Abseits eckiger Welten