Version vom 28. Juni 2005, 13:54 Uhr

Hinweis: Dieser Artikel ist noch unvollständig. (Mehr Informationen/weitere Artikel) {{{1}}}

glMap2

Name

glMap2 - definiert einen 2 demensionalen Bezieher

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

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 weitern OpenGL Verarbeitungsstufen 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.

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 Datei:glMap2 EvaluatorDefinition.png

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

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

Nocheinmal zur Erinnerung: Datei: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/glDiable 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

Datei:glMap12 u.png und Datei:glMap2 v.png ist.

Zur Kontrolle: glMap2 is used to define the basis and to specify what kind of values are produced. Once defined, a map can be enabled 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

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.

Each control point is three floating-point values representing x, y, and z. Internal glVertex3 commands are generated when the map is evaluated.

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.

Each control point is four floating-point values representing x, y, z, and w. Internal glVertex4 commands are generated when the map is evaluated.

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.

Each control point is a single floating-point value representing a 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

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.

Each control point is four floating-point values representing 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

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.

Each control point is three floating-point values representing 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

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.

Each control point is a single floating-point value representing 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

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.

Each control point is two 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

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.

Each control point is three 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

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.

Each control point is four 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, 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) ).

ustride, uorder, vstride, vorder, and points define the 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)

Hinweise

As is the case with all GL commands that accept pointers to data, it is as if the contents of points were copied by 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.

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

• glGetMap
• glGet mit Token GL_MEIN_TOKEN
• glGet mit Token GL_MAP2_VERTEX_3
• glGet mit Token GL_MAP2_VERTEX_4
• glGet mit Token GL_MAP2_INDEX
• glGet mit Token GL_MAP2_COLOR_4
• glGet mit Token GL_MAP2_NORMAL
• glGet mit Token GL_MAP2_TEXTURE_COORD_1
• glGet mit Token GL_MAP2_TEXTURE_COORD_2
• glGet mit Token GL_MAP2_TEXTURE_COORD_3
• glGet mit Token GL_MAP2_TEXTURE_COORD_4

Siehe auch

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