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
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 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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin

glEnd

glEvalCoord

glEvalMesh

glEvalPoint

glMap1

glMap2