glGetPixelMap

Aus DGL Wiki
Wechseln zu: Navigation, Suche

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ährend der Ausführung von glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D und glTexImage2D benutzt, um Farben- oder Stencilindizes 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