glMapGrid1d-Funktion

Definiert ein eindimensionales Gitter.

Syntax

void WINAPI glMapGrid1d(
   GLint    un,
   GLdouble u1,
   GLdouble 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 Ganzzahlrasterdomä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
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

Verwenden Sie die Funktionen glMapGrid und glEvalMesh zusammen, um eine Reihe von Domänenwerten mit gleichmäßigem Abstand effizient 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

Siehe auch

glBegin

glEnd

glEvalCoord

glEvalMesh

glEvalPoint

glMap1

glMap2