glEvalMesh

Aus DGL Wiki
Wechseln zu: Navigation, Suche

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 fest bei welchen Vertex von der mit glMapGrid1 generierten Vertex-Reihe die Kurve beginnt und bei welchen sie aufhört. Bei einem Gitter werden alle Vertrizen von die in dem von dem Vertex (i1/j1) und (i2/j2) begrenzten Rechteck liegen gezeichnet.


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

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