glGetHistogramParameter: Unterschied zwischen den Versionen
(neu erstellt) |
(an manpages angepasst) |
||
| Zeile 7: | Zeile 7: | ||
<br> | <br> | ||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
| − | procedure '''glGetHistogramParameterfv'''(''target'': TGLenum; ''pname'': TGLenum; ''params'': PGLfloat); | + | procedure '''glGetHistogramParameterfv'''(''target'': TGLenum; ''pname'': TGLenum; |
| − | procedure '''glGetHistogramParameteriv'''(''target'': TGLenum; ''pname'': TGLenum; ''params'': PGLint); | + | ''params'': PGLfloat); |
| + | procedure '''glGetHistogramParameteriv'''(''target'': TGLenum; ''pname'': TGLenum; | ||
| + | ''params'': PGLint); | ||
<br> | <br> | ||
| Zeile 20: | Zeile 22: | ||
|- | |- | ||
! ''params'' | ! ''params'' | ||
| − | | | + | | Zeiger auf Speicher für die zurückgelieferten Werte. |
|} | |} | ||
| Zeile 26: | Zeile 28: | ||
== Beschreibung == | == Beschreibung == | ||
| − | '''glGetHistogramParameter''' | + | '''glGetHistogramParameter''' wird benutzt um Parameterwerte für das aktuelle Histogramm oder für einen Proxy abzufragen. Die Statusinformationen des Histogramms können durch den Aufruf '''glGetHistogramParameter''' mit '''GL_HISTOGRAM''' für ''target'' (um Informationen über die aktuelle Histogramm-Tabelle zu erhalten) oder '''GL_PROXY_HISTOGRAM''' (um Informationen über die letzte Proxy-Abfrage zu erhalten) und einem der folgenden Werte für das ''pname''-Argument abgefragt werden : |
| − | |||
| − | |||
'''GL_HISTOGRAM_FORMAT''' | '''GL_HISTOGRAM_FORMAT''' | ||
| Zeile 34: | Zeile 34: | ||
'''GL_HISTOGRAM_WIDTH''' | '''GL_HISTOGRAM_WIDTH''' | ||
| − | : Liefert die Breite. | + | : Liefert die Breite der Histogramm-Tabelle. |
'''GL_HISTOGRAM_RED_SIZE''' | '''GL_HISTOGRAM_RED_SIZE''' | ||
| − | : Liefert die | + | : Liefert die Grösse des Zählers für die rote Farbkomponente in Bit. |
'''GL_HISTOGRAM_GREEN_SIZE''' | '''GL_HISTOGRAM_GREEN_SIZE''' | ||
| − | : Liefert die | + | : Liefert die Grösse des Zählers für die grüne Farbkomponente in Bit. |
'''GL_HISTOGRAM_BLUE_SIZE''' | '''GL_HISTOGRAM_BLUE_SIZE''' | ||
| − | : Liefert die | + | : Liefert die Grösse des Zählers für die blaue Farbkomponente in Bit. |
'''GL_HISTOGRAM_ALPHA_SIZE''' | '''GL_HISTOGRAM_ALPHA_SIZE''' | ||
| − | : Liefert die | + | : Liefert die Grösse des Zählers für die Alpha-Komponente in Bit. |
'''GL_HISTOGRAM_LUMINANCE_SIZE''' | '''GL_HISTOGRAM_LUMINANCE_SIZE''' | ||
| − | : Liefert die | + | : Liefert die Grösse des Zählers für die Helligkeits-Komponente in Bit. |
'''GL_HISTOGRAM_SINK''' | '''GL_HISTOGRAM_SINK''' | ||
| Zeile 56: | Zeile 56: | ||
<br> | <br> | ||
== Hinweise == | == Hinweise == | ||
| + | Die Funktion '''glGetHistogramParameter''' ist erst ab OpenGL Version 1.2 verfügbar. | ||
| + | |||
| + | '''glGetHistogramParameter''' ist nur verfügbar, falls '''GL_ARB_imaging''' beim Aufruf der Funktion [[glGetString]] mit dem Argument '''GL_EXTENSIONS''' zurückgegeben wird. | ||
| + | |||
Der Parameter '''GL_HISTOGRAM_SINK''' kann nicht zusammen mit dem ''target'' '''GL_PROXY_HISTOGRAM''' verwendet werden. | Der Parameter '''GL_HISTOGRAM_SINK''' kann nicht zusammen mit dem ''target'' '''GL_PROXY_HISTOGRAM''' verwendet werden. | ||
Version vom 10. April 2006, 14:55 Uhr
Inhaltsverzeichnis
glGetHistogramParameter
Name
glGetHistogramParameter - dient zur Abfrage der verschiedenen Histogramm-Parameter.
Delphi-Spezifikation
procedure glGetHistogramParameterfv(target: TGLenum; pname: TGLenum;
params: PGLfloat);
procedure glGetHistogramParameteriv(target: TGLenum; pname: TGLenum;
params: PGLint);
Parameter
| target | Muss GL_HISTOGRAM oder GL_PROXY_HISTOGRAM sein. |
|---|---|
| pname | Gibt den symbolischen Namen des Histogram-Parameters an, der abgefragt werden soll. Akzeptierte Werte sind GL_HISTOGRAM_FORMAT, GL_HISTOGRAM_WIDTH, GL_HISTOGRAM_RED_SIZE, GL_HISTOGRAM_GREEN_SIZE, GL_HISTOGRAM_BLUE_SIZE, GL_HISTOGRAM_ALPHA_SIZE, GL_HISTOGRAM_LUMINANCE_SIZE und GL_HISTOGRAM_SINK. |
| params | Zeiger auf Speicher für die zurückgelieferten Werte. |
Beschreibung
glGetHistogramParameter wird benutzt um Parameterwerte für das aktuelle Histogramm oder für einen Proxy abzufragen. Die Statusinformationen des Histogramms können durch den Aufruf glGetHistogramParameter mit GL_HISTOGRAM für target (um Informationen über die aktuelle Histogramm-Tabelle zu erhalten) oder GL_PROXY_HISTOGRAM (um Informationen über die letzte Proxy-Abfrage zu erhalten) und einem der folgenden Werte für das pname-Argument abgefragt werden :
GL_HISTOGRAM_FORMAT
- Liefert das interne Format.
GL_HISTOGRAM_WIDTH
- Liefert die Breite der Histogramm-Tabelle.
GL_HISTOGRAM_RED_SIZE
- Liefert die Grösse des Zählers für die rote Farbkomponente in Bit.
GL_HISTOGRAM_GREEN_SIZE
- Liefert die Grösse des Zählers für die grüne Farbkomponente in Bit.
GL_HISTOGRAM_BLUE_SIZE
- Liefert die Grösse des Zählers für die blaue Farbkomponente in Bit.
GL_HISTOGRAM_ALPHA_SIZE
- Liefert die Grösse des Zählers für die Alpha-Komponente in Bit.
GL_HISTOGRAM_LUMINANCE_SIZE
- Liefert die Grösse des Zählers für die Helligkeits-Komponente in Bit.
GL_HISTOGRAM_SINK
- Liefert GL_TRUE wenn die Pixel in der Imaging-Pipeline nach der Histogramm-Operation nicht weitergereicht werden sollen, ansonsten GL_FALSE.
Hinweise
Die Funktion glGetHistogramParameter ist erst ab OpenGL Version 1.2 verfügbar.
glGetHistogramParameter ist nur verfügbar, falls GL_ARB_imaging beim Aufruf der Funktion glGetString mit dem Argument GL_EXTENSIONS zurückgegeben wird.
Der Parameter GL_HISTOGRAM_SINK kann nicht zusammen mit dem target GL_PROXY_HISTOGRAM verwendet werden.
Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von params durchgeführt.
Fehlermeldungen
GL_INVALID_ENUM wird generiert wenn target oder pname ungültige Werte übergeben werden.
GL_INVALID_OPERATION wird generiert wenn glGetHistogramParameter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.
