glGetHistogramParameter

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.

Siehe auch

glGetHistogram, glHistogram, glResetHistogram

Hintergrundwissen: Histogram