glMapGrid1f-Funktion
Definiert ein eindimensionales Gitter.
Syntax
void WINAPI glMapGrid1f(
GLint un,
GLfloat u1,
GLfloat u2
);
Parameter
-
un
-
Die Anzahl der Partitionen im Rasterbereichsintervall [u1, u2]. Dieser Wert muss positiv sein.
-
u1
-
Ein Wert, der als Zuordnung für den Ganzzahlrasterdomänenwert i = 0 verwendet wird.
-
u2
-
Ein Wert, der als Zuordnung für den ganzzahligen Rasterdomänenwert i = un verwendet wird.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Entweder un oder vn war nicht positiv. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die Funktionen glMapGrid und glEvalMesh werden gleichzeitig verwendet, um eine Reihe von Gleichmäßigkeitszuordnungsdomänenwerten effizient zu generieren und auszuwerten. Die funktion glEvalMesh durchläuft die ganze Domäne eines ein- oder zweidimensionalen Rasters, dessen Bereich die Domäne der von glMap1 und glMap2 angegebenen Auswertungszuordnungen ist.
Die Funktionen glMapGrid1 und glMapGrid2 geben die linearen Rasterzuordnungen zwischen den ganzzahligen Rasterkoordinaten i (oder i und j) bis zu den Koordinaten der Gleitkommaauswertungszuordnung u (oder Sie und v) an. Unter glMap1 und glMap2 finden Sie Details dazu, wie Sie und v-Koordinaten ausgewertet werden.
Die glMapGrid1-Funktion gibt eine einzelne lineare Zuordnung an, so dass ganzzahlige Rasterkoordinate 0 genau u1 und ganzzahlige Rasterkoordinaten un genau zu u2 zugeordnet werden. Alle anderen ganzzahligen Rasterkoordinaten i sind so zugeordnet, dass:
u = i(u2 u1)/un + u1
Die glMapGrid2-Funktion gibt zwei solche linearen Zuordnungen an. Eine ordnet die ganzzahlige Rasterkoordinate i = 0 genau zu u1 und die ganzzahlige Rasterkoordinate i = un genau zu u2 zu. Die andere ordnet die ganzzahlige Rasterkoordinate j = 0 genau v1 und die ganzzahlige Rasterkoordinate j = vn genau zu v2 zu. Andere ganzzahlige Rasterkoordinaten i und j werden so zugeordnet, dass
u = i(u2 u1)/un + u1
v = j (v2 v1)/vn + v1
Die von glMapGrid angegebenen Zuordnungen werden von glEvalMesh und glEvalPoint identisch verwendet.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glMapGrid ab:
glGet mit Argument GL_MAP1_GRID_DOMAIN
glGet mit Argument GL_MAP2_GRID_DOMAIN
glGet with argument GL_MAP1_GRID_SEGMENTS
glGet mit Argument GL_MAP2_GRID_SEGMENTS
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 |
|