Aktuelle Version vom 1. Februar 2007, 15:27 Uhr

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

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.

Siehe auch

glGetHistogram, glHistogram, glResetHistogram

Hintergrundwissen: Histogram