glGetPixelMapusv-Funktion

Die Funktionen glGetPixelMapfv, glGetPixelMapuivund glGetPixelMapusv geben die angegebene Pixelzuordnung zurück.

Syntax

void WINAPI glGetPixelMapusv(
   GLenum   map,
   GLushort *values
);

Parameter

map

Der Name der zurückzukehrenden Pixelzuordnung. Akzeptierte 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
GL _ INVALID _ ENUM
map war kein akzeptierter Wert.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Hinweise

Eine Beschreibung der zulässigen Werte für den map-Parameter finden Sie unter glPixelMap. Die glGetPixelMap-Funktion gibt in Werten den Inhalt der Pixelzuordnung zurück, die in map angegeben ist. Verwenden Sie Pixelzuordnungen während der Ausführung von glReadPixels, glDrawPixels, glCopyPixels, glTexImage1Dund glTexImage2D, um Farbindizes, Schablonenindizes, Farbkomponenten und Tiefenkomponenten anderen Werten zu zuordnen.

Ganzzahlwerte ohne Vorzeichen werden, falls angefordert, linear aus der internen festen Darstellung oder Gleitkommadarstellung zugeordnet, damit 1,0 dem größten darstellbaren ganzzahligen Wert und 0,0 null zugeordnet wird. Rückgabewerte für ganze Zahlen ohne Vorzeichen sind nicht definiert, wenn der Zuordnungswert nicht im Bereich [ von 0,1 ] liegt.

Um die erforderliche Größe der Zuordnung zu bestimmen, rufen Sie glGet mit der entsprechenden symbolischen Konstante auf.

Wenn ein Fehler generiert wird, wird keine Änderung 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 dem 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

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

glCopyPixels

glDrawPixels

glEnd

glGet

glPixelMap

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D