glGetPixelMapusv-Funktion

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

Syntax

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

Parameter

map

Der Name der zurückzugebenden 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.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Eine Beschreibung der zulässigen Werte für den Kartenparameter finden Sie unter glPixelMap. Die glGetPixelMap-Funktion gibt in Werten den Inhalt der in der Karte angegebenen Pixelzuordnung zurück. Verwenden Sie Pixelzuordnungen während der Ausführung von glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D und glTexImage2D , um Farbindizes, Schablonenindizes, Farbkomponenten und Tiefenkomponenten anderen Werten zuzuordnen.

Ganzzahlwerte ohne Vorzeichen werden bei Bedarf linear aus der internen Festen- oder Gleitkommadarstellung zugeordnet, sodass 1,0 dem größten darstellbaren ganzzahligen Wert und 0,0 dem Nullwert zugeordnet wird. Rückgabewerte ohne Vorzeichen sind nicht definiert, wenn sich der Zuordnungswert nicht im Bereich [0,1] befand.

Um die erforderliche Größe der Karte zu bestimmen, rufen Sie glGet mit der entsprechenden symbolischen Konstanten 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

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