glGetPixelMapuiv-Funktion
Die Funktionen glGetPixelMapfv, glGetPixelMapuiv und glGetPixelMapusv geben die angegebene Pixelzuordnung zurück.
Syntax
void WINAPI glGetPixelMapuiv(
GLenum map,
GLuint *values
);
Parameter
-
map
-
Der Name der zurückzugebende Pixelzuordnung. Zulässige Werte sind GL _ PIXEL MAP I TO _ _ _ _ I, GL PIXEL MAP S _ _ TO _ _ _ S, GL PIXEL MAP I _ TO _ _ _ _ R, GL PIXEL MAP _ I TO _ _ _ _ G, GL PIXEL MAP I _ TO _ _ _ _ B, GL PIXEL MAP I _ TO _ _ _ _ A, GL PIXEL MAP R _ TO _ _ _ _ R, GL PIXEL MAP _ G TO _ _ _ _ G, GL PIXEL MAP _ B TO B und GL PIXEL MAP A _ TO _ _ _ _ _ _ _ _ A.
-
Werte
-
Gibt den Inhalt der Pixelzuordnung zurück.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
map war kein akzeptierter Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen. |
Bemerkungen
Eine Beschreibung der zulässigen Werte für den map-Parameter finden Sie unter glPixelMap. Die glGetPixelMap-Funktion gibt in -Werten den Inhalt der in map angegebenen Pixelzuordnung zurück. Verwenden Sie Pixelzuordnungen während der Ausführung von glReadPixels, glDrawPixels, glCopyPixels, glTexImage1Dund glTexImage2D, um Farbindizes, Schablonenindizes, Farbkomponenten und Tiefenkomponenten anderen Werten zuzuordnen.
Ganzzahlige Werte ohne Vorzeichen werden, falls angefordert, linear aus der internen festen oder Gleitkommadarstellung zugeordnet, sodass 1,0 dem größten darstellbaren ganzzahligen Wert und 0,0 null zugeordnet wird. Rückgabewerte ganzzahliger Zahlen ohne Vorzeichen sind nicht definiert, wenn der Zuordnungswert nicht im Bereich [ von 0,1 ] lag.
Um die erforderliche Größe der Zuordnung zu bestimmen, rufen Sie glGet mit der entsprechenden symbolischen Konstante auf.
Wenn ein Fehler generiert wird, werden keine Änderungen am Inhalt der Werte vorgenommen.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glGetPixelMap ab:
glGet mit Argument GL _ PIXEL MAP I TO I _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP S TO S _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP I TO R _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP I TO G _ _ _ _ _ SIZE
glGet mit Argument GL _ PIXEL MAP I TO B _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP I TO A _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP R TO R _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP G TO G _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP B TO B _ _ _ _ _ SIZE
glGet mit argument GL _ PIXEL MAP A TO A _ _ _ _ _ SIZE
glGet mit argument GL _ MAX PIXEL MAP _ _ _ TABLE
Requirements (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 |
|