glMapGrid2d-Funktion
Definiert ein eindimensionales Gitter.
Syntax
void WINAPI glMapGrid2d(
GLint un,
GLdouble u1,
GLdouble u2,
GLint vn,
GLdouble v1,
GLdouble v2
);
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 Ganzzahlrasterdomänenwert i = un verwendet wird.
-
vn
-
Die Anzahl der Partitionen im Rasterbereichsintervall [v1, v2].
-
v1
-
Ein Wert, der als Zuordnung für den Ganzzahlrasterdomänenwert j = 0 verwendet wird.
-
v2
-
Ein Wert, der als Zuordnung für den Ganzzahlrasterdomänenwert j = vn 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 zusammen verwendet, um effizient eine Reihe von Kartendomänenwerten mit gleichmäßigem Abstand zu generieren und auszuwerten. Die glEvalMesh-Funktion durchläuft die Ganzzahldomä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, sodass die ganzzahlige Rasterkoordinate 0 genau u1 und ganzzahlige Rasterkoordinaten un genau u2 zugeordnet werden. Alle anderen ganzzahligen Rasterkoordinaten i werden 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 = ungenauzu u2. Die andere ganzzahlige Rasterkoordinate j = 0 genau v1 und ganzzahlige Rasterkoordinate j = vn genau zu v2. 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 mit 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 |
|