glGetPixelMap: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(Neuer Artikel)
 
K (Beschreibung: WäHrend)
 
(4 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= glGetPixelMap =
 
= glGetPixelMap =
  
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
 
'''glGetPixelMapfv, glGetPixelMapuiv, glGetPixelMapusv''' - liefert die angegebene Pixelkarte (engl.: pixel map).
 
'''glGetPixelMapfv, glGetPixelMapuiv, glGetPixelMapusv''' - liefert die angegebene Pixelkarte (engl.: pixel map).
<br>
+
 
 +
 
 +
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
  
Zeile 11: Zeile 14:
 
  procedure '''glGetPixelMapusv'''(''map'': TGLenum; ''values'': PGLushort);
 
  procedure '''glGetPixelMapusv'''(''map'': TGLenum; ''values'': PGLushort);
  
<br>
+
 
 +
 
  
 
== Parameter ==
 
== Parameter ==
Zeile 24: Zeile 28:
 
|}
 
|}
  
<br>
+
 
 +
 
  
 
== Beschreibung ==  
 
== Beschreibung ==  
Lesen Sie den Artikel [[glPixelMap]] um eine detailierte Beschreibung der Werte für ''map'' zu erhalten.
+
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).
+
'''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  
 
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
 
*1.0 dem größten Integerwert entspricht und
 
*0.0 auf 0 übertragen wird.
 
*0.0 auf 0 übertragen wird.
Vorzeichenlose ganzahlige Rückgabewerte sind undefiniert wenn der Map-Wert nicht im Interval [0,1] lag.
+
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.
 
Um die benötigte Größe für eine Map zu ermitteln, rufen sie [[glGet]] mit der entsprechenden symbolischen Konstante auf.
  
<br>
 
 
== Hinweise ==
 
== Hinweise ==
 
Tritt ein Fehler auf, bleibt der Inhalt von ''values'' unverändert.
 
Tritt ein Fehler auf, bleibt der Inhalt von ''values'' unverändert.
  
<br>
+
 
 +
 
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
'''GL_INVALID_ENUM''' wird generiert wenn ''map'' ein ungültiger Wert übergeben wurde.<br>
+
'''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.  
+
 
 +
'''GL_INVALID_OPERATION''' wird generiert, wenn '''glGetPixelMap''' innerhalb eines [[glBegin]]-[[glEnd]]-Blocks aufgerufen wird.  
 +
 
 +
 
 +
 
 +
 
 +
== Zugehörige Wertrückgaben ==
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_I_SIZE|GL_PIXEL_MAP_I_TO_I_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_S_TO_S_SIZE|GL_PIXEL_MAP_S_TO_S_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_R_SIZE|GL_PIXEL_MAP_I_TO_R_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_G_SIZE|GL_PIXEL_MAP_I_TO_G_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_B_SIZE|GL_PIXEL_MAP_I_TO_B_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_A_SIZE|GL_PIXEL_MAP_I_TO_A_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_R_TO_R_SIZE|GL_PIXEL_MAP_R_TO_R_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_G_TO_G_SIZE|GL_PIXEL_MAP_G_TO_G_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_B_TO_B_SIZE|GL_PIXEL_MAP_B_TO_B_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_A_TO_A_SIZE|GL_PIXEL_MAP_A_TO_A_SIZE]]
 +
 
 +
[[glGet]] mit Token [[glGet#GL_MAX_PIXEL_MAP_TABLE|GL_MAX_PIXEL_MAP_TABLE]]
  
<br>
 
  
==  Zugehörige Wertrückgaben ==
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_I_SIZE|GL_PIXEL_MAP_I_TO_I_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_S_TO_S_SIZE|GL_PIXEL_MAP_S_TO_S_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_R_SIZE|GL_PIXEL_MAP_I_TO_R_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_G_SIZE|GL_PIXEL_MAP_I_TO_G_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_B_SIZE|GL_PIXEL_MAP_I_TO_B_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_I_TO_A_SIZE|GL_PIXEL_MAP_I_TO_A_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_R_TO_R_SIZE|GL_PIXEL_MAP_R_TO_R_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_G_TO_G_SIZE|GL_PIXEL_MAP_G_TO_G_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_B_TO_B_SIZE|GL_PIXEL_MAP_B_TO_B_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_PIXEL_MAP_A_TO_A_SIZE|GL_PIXEL_MAP_A_TO_A_SIZE]]<br>
 
[[glGet]] mit Token [[glGet#GL_MAX_PIXEL_MAP_TABLE|GL_MAX_PIXEL_MAP_TABLE]]<br>
 
  
<br>
 
  
 
== Siehe auch ==
 
== Siehe auch ==
Zeile 68: Zeile 86:
  
 
[[Kategorie:GL|GetPixelMap]]
 
[[Kategorie:GL|GetPixelMap]]
 +
[[Kategorie:GL1.0|GetPixelMap]]

Aktuelle Version vom 18. März 2012, 16:45 Uhr

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