glMap1f-Funktion
Die Funktionen glMap1d und glMap1f definieren eine eindimensionale Auswertung.
Syntax
void WINAPI glMap1f(
GLenum target,
GLfloat u1,
GLfloat u2,
GLint stride,
GLint order,
const GLfloat *points
);
Parameter
-
Ziel
-
Die Art von Werten, die vom Evaluator generiert werden. Symbolische Konstanten. Der Zielparameter ist eine symbolische Konstante, die angibt, welche Art von Kontrollpunkten in Punkten bereitgestellt werden und welche Ausgabe generiert wird, wenn die Zuordnung ausgewertet wird. Er kann einen von neun vordefinierten Werten annehmen.
Wert Bedeutung - GL_MAP1_VERTEX_3
Jeder Kontrollpunkt besteht aus drei Gleitkommawerten , die x, y und z darstellen. Interne glVertex3-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. - GL_MAP1_VERTEX_4
Jeder Kontrollpunkt besteht aus vier Gleitkommawerten , die x, y, z und w darstellen. Interne glVertex4-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. - GL_MAP1_INDEX
Jeder Kontrollpunkt ist ein einzelner Gleitkommawert, der einen Farbindex darstellt. Interne glIndex-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. Der aktuelle Index wird jedoch nicht mit dem Wert dieser glIndex-Befehle aktualisiert. - GL_MAP1_COLOR_4
Jeder Kontrollpunkt besteht aus vier Gleitkommawerten, die Rot, Grün, Blau und Alpha darstellen. Interne glColor4-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. Die aktuelle Farbe wird jedoch nicht mit dem Wert dieser glColor4-Befehle aktualisiert. - GL_MAP1_NORMAL
Jeder Kontrollpunkt besteht aus drei Gleitkommawerten, die die x-, y - und z-Komponenten eines normalen Vektors darstellen. Interne glNormal-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. Die aktuelle Normalität wird jedoch nicht mit dem Wert dieser glNormal-Befehle aktualisiert. - GL_MAP1_TEXTURE_COORD_1
Jeder Kontrollpunkt ist ein einzelner Gleitkommawert, der die Texturkoordinate von s darstellt. Interne glTexCoord1-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. Die aktuellen Texturkoordinaten werden jedoch nicht mit dem Wert dieser glTexCoord-Befehle aktualisiert. - GL_MAP1_TEXTURE_COORD_2
Jeder Kontrollpunkt besteht aus zwei Gleitkommawerten, die die Texturkoordinaten s und t darstellen. Interne glTexCoord2-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. Die aktuellen Texturkoordinaten werden jedoch nicht mit dem Wert dieser glTexCoord-Befehle aktualisiert. - GL_MAP1_TEXTURE_COORD_3
Jeder Kontrollpunkt besteht aus drei Gleitkommawerten, die die Texturkoordinaten s, t und r darstellen. Interne glTexCoord3-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. Die aktuellen Texturkoordinaten werden jedoch nicht mit dem Wert dieser glTexCoord-Befehle aktualisiert. - GL_MAP1_TEXTURE_COORD_4
Jeder Kontrollpunkt besteht aus vier Gleitkommawerten, die die Texturkoordinaten s, t, r und q darstellen. Interne glTexCoord4-Befehle werden generiert, wenn die Zuordnung ausgewertet wird. Die aktuellen Texturkoordinaten werden jedoch nicht mit dem Wert dieser glTexCoord-Befehle aktualisiert. -
u1
-
Eine lineare Zuordnung von u, wie für glEvalCoord1 dargestellt, zu u^, der Variablen, die durch die von diesem Befehl angegebenen Formeln ausgewertet wird.
-
u2
-
Eine lineare Zuordnung von u, wie für glEvalCoord1 dargestellt, zu u^, der Variablen, die durch die von diesem Befehl angegebenen Formeln ausgewertet wird.
-
Schritt
-
Die Anzahl der Gleitkommapunkte zwischen dem Anfang eines Kontrollpunkts und dem Anfang des nächsten in der Datenstruktur, auf die in Punkten verwiesen wird. Dadurch können Kontrollpunkte in beliebige Datenstrukturen eingebettet werden. Die einzige Einschränkung besteht darin, dass die Werte für einen bestimmten Kontrollpunkt zusammenhängende Speicherspeicherorte belegen müssen.
-
order
-
Die Anzahl der Kontrollpunkte. Muss positiv sein.
-
Punkte
-
Ein Zeiger auf das Array von Steuerpunkten.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
target war kein akzeptierter Wert. |
|
u1 war gleich u2. |
|
stride war kleiner als die Anzahl der Werte in einem Kontrollpunkt. |
|
Order war kleiner als ein oder GL_MAX_EVAL_ORDER. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Evaluatoren bieten eine Möglichkeit, polynomiale oder rationale Polynomzuordnungen zu verwenden, um Scheitelpunkte, Normalwerte, Texturkoordinaten und Farben zu erzeugen. Die von einem Evaluator erzeugten Werte werden an weitere Phasen der OpenGL-Verarbeitung gesendet, so als ob sie mithilfe der Befehle glVertex, glNormal, glTexCoord und glColor dargestellt worden seien, mit der Ausnahme, dass die generierten Werte nicht die aktuelle Normal-, Texturkoordinaten oder Farbe aktualisieren.
Alle polynomalen oder rationalen polynomialen Splines eines beliebigen Grades (bis zum maximalen Grad, der von der OpenGL-Implementierung unterstützt wird) können mithilfe von Evaluatoren beschrieben werden. Dazu gehören fast alle Splines, die in Computergrafiken verwendet werden, einschließlich B-Splines, Bézierkurven, Hermite-Splines usw.
Evaluatoren definieren Kurven basierend auf Bernsteinpolynomen. Definieren Sie p () als
Dabei ist Ri ein Kontrollpunkt und () das i das Bernstein-Polynom von Grad n (Reihenfolge =n + 1):
Erinnern Sie sich daran, dass
Die glMap1-Funktion wird verwendet, um die Basis zu definieren und anzugeben, welche Art von Werten erzeugt werden. Nach der Definition kann eine Karte aktiviert und deaktiviert werden, indem glEnable und glDisable mit dem Kartennamen aufgerufen werden, einem der neun vordefinierten Werte für das oben beschriebene Ziel. Die glEvalCoord1-Funktion wertet die aktivierten eindimensionalen Zuordnungen aus. Wenn glEvalCoord1 den Wert u darstellt, werden die Bernstein-Funktionen mit u^ ausgewertet, wobei
Die Parameter stride, order und points definieren die Arrayadressierung für den Zugriff auf die Kontrollpunkte. Der Punktparameter ist die Position des ersten Kontrollpunkts, der einen, zwei, drei oder vier zusammenhängende Speicherstandorte einnimmt, je nachdem, welche Karte definiert wird. Der Order-Parameter ist die Anzahl der Kontrollpunkte im Array. Der stride-Parameter gibt an, wie viele float- oder double-Speicherorte der interne Speicherzeiger zum Erreichen des nächsten Steuerungspunkts voranbringen soll.
Wie bei allen OpenGL-Befehlen, die Zeiger auf Daten akzeptieren, ist es so, als ob der Inhalt der Punkte von glMap1 kopiert wurde, bevor er zurückgegeben wird. Änderungen am Inhalt von Punkten wirken sich nach dem Aufruf von glMap1 nicht aus.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glMap1 ab:
glGet mit Argument GL_MAX_EVAL_ORDER
glIsEnabled mit Argument GL_MAP1_VERTEX_3
glIsEnabled mit Argument GL_MAP1_VERTEX_4
glIsEnabled mit Argument GL_MAP1_INDEX
glIsEnabled mit Argument GL_MAP1_COLOR_4
glIsEnabled mit Argument GL_MAP1_NORMAL
glIsEnabled mit Argument GL_MAP1_TEXTURE_COORD_1
glIsEnabled mit Argument GL_MAP1_TEXTURE_COORD_2
glIsEnabled mit Argument GL_MAP1_TEXTURE_COORD_3
glIsEnabled mit Argument GL_MAP1_TEXTURE_COORD_4
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|