glGetPixelMap

glGetPixelMap

Name

glGetPixelMapfv, glGetPixelMapuiv, glGetPixelMapusv - liefert die angegebene Pixelkarte (engl.: pixel map).

Delphi-Spezifikation

procedure glGetPixelMapfv(map: TGLenum; values: PGLfloat);
procedure glGetPixelMapuiv(map: TGLenum; values: PGLuint);
procedure glGetPixelMapusv(map: TGLenum; values: PGLushort);

Parameter

map	Bezeichnet den Namen der zu liefernden Pixelmap. 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, and GL_PIXEL_MAP_A_TO_A.
values	Liefert den Inhalt der Pixelmaps.

Beschreibung

Lesen Sie den Artikel glPixelMap um eine detailierte Beschreibung der Werte für map zu erhalten.

glGetPixelMap liefert über values den Inhalt der Pixelmap zurück, die mittels map angegeben wird. Pixelmaps werden wärend der Ausführung von glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D und glTexImage2D benutz um Farben- oder Stencil-indizes sowie Farb- und Tiefenkomponenten auf andere Werte zu übertragen (engl.: mapping).

Vorzeichenlose Ganzzahlen werden, wenn abgefragt, linear von der internen Fest- oder Fließkommarepräsentation gemappt, so das

• 1.0 dem größten Integerwert entspricht und
• 0.0 auf 0 übertragen wird.

Vorzeichenlose ganzahlige Rückgabewerte sind undefiniert wenn der Map-Wert nicht im Interval [0,1] lag.

Um die benötigte Größe für eine Map zu ermitteln, rufen sie glGet mit der entsprechenden symbolischen Konstante auf.

Hinweise

Tritt ein Fehler auf, bleibt der Inhalt von values unverändert.

Fehlermeldungen

GL_INVALID_ENUM wird generiert wenn map ein ungültiger Wert übergeben wurde.
GL_INVALID_OPERATION wird generiert wenn glGetPixelMap innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Zugehörige Wertrückgaben

glGet mit Token GL_PIXEL_MAP_I_TO_I_SIZE
glGet mit Token GL_PIXEL_MAP_S_TO_S_SIZE
glGet mit Token GL_PIXEL_MAP_I_TO_R_SIZE
glGet mit Token GL_PIXEL_MAP_I_TO_G_SIZE
glGet mit Token GL_PIXEL_MAP_I_TO_B_SIZE
glGet mit Token GL_PIXEL_MAP_I_TO_A_SIZE
glGet mit Token GL_PIXEL_MAP_R_TO_R_SIZE
glGet mit Token GL_PIXEL_MAP_G_TO_G_SIZE
glGet mit Token GL_PIXEL_MAP_B_TO_B_SIZE
glGet mit Token GL_PIXEL_MAP_A_TO_A_SIZE
glGet mit Token GL_MAX_PIXEL_MAP_TABLE

Siehe auch

glCopyPixels, glDrawPixels, glPixelMap, glPixelTransfer, glReadPixels, glTexImage1D, glTexImage2D