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
GL_INVALID_VALUE	Entweder un oder vn war nicht positiv.
GL_INVALID_OPERATION	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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin

glEnd

glEvalCoord

glEvalMesh

glEvalPoint

glMap1

glMap2