glGetHistogramParameter: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(neu erstellt)
 
(→‎Siehe auch)
 
(2 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= glGetHistogramParameter =
 
= glGetHistogramParameter =
  
−
<br>
+
 
 +
 
 
== Name ==
 
== Name ==
 
'''glGetHistogramParameter''' - dient zur Abfrage der verschiedenen [[Histogramm]]-Parameter.
 
'''glGetHistogramParameter''' - dient zur Abfrage der verschiedenen [[Histogramm]]-Parameter.
  
−
<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>
 
 
== Parameter ==
 
== Parameter ==
 
{| border="1" rules="all"
 
{| border="1" rules="all"
Zeile 20: Zeile 25:
 
|-
 
|-
 
! ''params''
 
! ''params''
−
| Liefert den angeforderten Histogramm-Parameter.
+
| Zeiger auf Speicher für die zurückgelieferten Werte.
 
|}
 
|}
  
−
<br>
+
 
 +
 
  
 
== Beschreibung ==  
 
== Beschreibung ==  
−
'''glGetHistogramParameter''' liefert über die Rückgabevariable ''params'' den Wert der Histogramm-Eigenschaft, die mit ''pname'' angegeben wurde.<br>
+
'''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 :
−
 
 
−
Folgende Eigenschaften für das Histogramm sind abfragbar :
 
  
 
'''GL_HISTOGRAM_FORMAT'''
 
'''GL_HISTOGRAM_FORMAT'''
Zeile 34: Zeile 38:
  
 
'''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 Auflösung der roten Farbkomponente in Bit.
+
: Liefert die Grösse des Zählers für die rote Farbkomponente in Bit.
  
 
'''GL_HISTOGRAM_GREEN_SIZE'''
 
'''GL_HISTOGRAM_GREEN_SIZE'''
−
: Liefert die Auflösung der grünen Farbkomponente in Bit.
+
: 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 Auflösung der roten Farbkomponente in Bit.
+
: Liefert die Grösse des Zählers für die blaue Farbkomponente in Bit.
  
 
'''GL_HISTOGRAM_ALPHA_SIZE'''
 
'''GL_HISTOGRAM_ALPHA_SIZE'''
−
: Liefert die Auflösung der Alpha-Komponente in Bit.
+
: Liefert die Grösse des Zählers für die Alpha-Komponente in Bit.
  
 
'''GL_HISTOGRAM_LUMINANCE_SIZE'''
 
'''GL_HISTOGRAM_LUMINANCE_SIZE'''
−
: Liefert die Auflösung der Helligkeits-Komponente in Bit.
+
: Liefert die Grösse des Zählers für die Helligkeits-Komponente in Bit.
  
 
'''GL_HISTOGRAM_SINK'''
 
'''GL_HISTOGRAM_SINK'''
 
: Liefert '''GL_TRUE''' wenn die Pixel in der [[Imaging-Pipeline]] nach der Histogramm-Operation nicht weitergereicht werden sollen, ansonsten '''GL_FALSE'''.
 
: Liefert '''GL_TRUE''' wenn die Pixel in der [[Imaging-Pipeline]] nach der Histogramm-Operation nicht weitergereicht werden sollen, ansonsten '''GL_FALSE'''.
  
−
<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.
  
 
Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von ''params'' durchgeführt.
 
Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von ''params'' durchgeführt.
  
−
<br>
+
 
 +
 
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
 
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' oder ''pname'' ungültige Werte übergeben werden. <br>
 
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' oder ''pname'' ungültige Werte übergeben werden. <br>
 
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGetHistogramParameter''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
 
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGetHistogramParameter''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
  
−
<br>
+
 
 +
 
 
== Siehe auch ==
 
== Siehe auch ==
 
[[glGetHistogram]], [[glHistogram]], [[glResetHistogram]]
 
[[glGetHistogram]], [[glHistogram]], [[glResetHistogram]]
 +
 +
Hintergrundwissen: [[Histogram]]
 +
  
 
[[Kategorie:GL|GetHistogramParameter]]
 
[[Kategorie:GL|GetHistogramParameter]]

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

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

Abgerufen von „https://wiki.delphigl.com/index.php?title=glGetHistogramParameter&oldid=20174“