glHistogram - Versionsgeschichte

Flash: /* Siehe auch */

2007-02-01T14:27:19Z

‎Siehe auch

Flash: /* Beschreibung */ Bild hinzugefügt

2006-08-29T14:50:26Z

‎Beschreibung: Bild hinzugefügt

DGLBot: Bot: konvertiere/korrigiere

2006-04-22T18:21:43Z

Bot: konvertiere/korrigiere <BR>

Dj3hut1: an manpages angepasst

2006-04-10T10:13:25Z

an manpages angepasst

Dj3hut1: falscher Hinweis korrigiert

2006-04-07T17:20:19Z

falscher Hinweis korrigiert

Flash: /* Parameter */

2006-04-07T11:39:19Z

‎Parameter

Dj3hut1: neu erstellt

2006-04-06T19:59:58Z

neu erstellt

Neue Seite

= glHistogram =

<br>
== Name ==
'''glHistogram''' - definiert, wie die Daten eines Histogramms gespeichert werden sollen.

== Delphi-Spezifikation ==
procedure '''glHistogram'''(''target'' : TGLenum; ''width'' : TGLsizei; ''internalformat'' : TGLenum;
''sink'' : TGLboolean)

== Parameter ==

{| border="1" rules="all"
! ''target''
| Muss einer der folgenden Konstanten sein: '''GL_HISTROGRAM''' oder '''GL_PROXY_HISTOGRAM'''.
|-
! ''width''
| Anzahl der Einträge des Histogramms. Muss eine Zahl vom Typ 2^n (n: Integer) sein.
|-
! ''internalformat''
| Das interne Format der Histogramm-Daten. Zulässige Werte sind '''GL_ALPHA''', '''GL_ALPHA4''', '''GL_ALPHA8''', '''GL_ALPHA12''', '''GL_ALPHA16''', '''GL_LUMINANCE''', '''GL_LUMINANCE4''', '''GL_LUMINANCE8''', '''GL_LUMINANCE12''', '''GL_LUMINANCE16''', '''GL_LUMINANCE_ALPHA''', '''GL_LUMINANCE4_ALPHA4''', '''GL_LUMINANCE6_ALPHA2''', '''GL_LUMINANCE8_ALPHA8''', '''GL_LUMINANCE12_ALPHA4''', '''GL_LUMINANCE12_ALPHA12''', '''GL_LUMINANCE16_ALPHA16''', '''GL_R3_G3_B2''', '''GL_RGB''', '''GL_RGB4''', '''GL_RGB5''', '''GL_RGB8''', '''GL_RGB10''', '''GL_RGB12''', '''GL_RGB16''', '''GL_RGBA''', '''GL_RGBA2''', '''GL_RGBA4''', '''GL_RGB5_A1''', '''GL_RGBA8''', '''GL_RGB10_A2''', '''GL_RGBA12''' und '''GL_RGBA16'''.
|-
! ''sink''
| Flag, ob die Pixel nach der Histogramm-Operation in den nächsten Prozess der [[Imaging Pipeline]] geschickt werden sollen ([[glMinmax]]).
|}

== Beschreibung ==
'''glHistogram''' kann für zwei Methoden verwendet werden: Ist ''target'' auf '''GL_PROXY_HISTOGRAM''' gesetzt, so wird geprüft, ob genügend Ressourcen zur Verfügung stehen, um intern ein Histogramm mit der angegebenen Grösse, dem Format und der Auflösung abzuspeichern.
Ist dies nicht der Fall, so werden all diese Werte auf 0 gesetzt.

Die Ergebnisse des Proxy-Kommandos können mit [[glGetHistogramParameter]] abgefragt werden.

Übergibt man '''GL_HISTOGRAM''' an ''target'', werden die Parameter für das Histogramm gesetzt.
''internalformat'' gibt dabei an, für welche Komponenten des Bildes ein Histogramm erstellt werden soll.
Alle Werte des Histogramms werden auf 0 gesetzt. Alle mit '''glHistogram''' vorher gesetzten Histogramme gehen verloren.

''width'' gibt an, wieviel Einträge das Histogramm haben soll. Die Farbwerte des Bildes werden dann in dementsprechende Bereiche eingeteilt und statistisch ausgewertet.
Genauer : Falls die Breite nicht 0 ist werden die Farbwerte zuerst auf den Bereich [0,1] gemapped, mit ''width'' - 1 multipliziert und auf den nächsten Integerwert gerundet.
Beispiel : wird bei einer Farbauflösung von 8 Bit (256 verschiedene Farbwerte möglich) der Wert 64 für ''width'' gesetzt, so werden für das Histogramm immer 256 / 64 = 4 Farbkomponenten zusammen als eine gezählt.

Mit dem Parameter ''sink'' wird bestimmt, wie nach der Histogramm-Operation fortgefahren werden werden soll. Bei '''GL_TRUE''' werden die Pixel in der Pipeline nicht weitergeleitet, ansonsten werden sie anschliessend mit dem Befehl [[glGetMinmax]] ausgewertet.

== Hinweise ==
'''glDrawElements''' ist erst ab GL Version 1.2 oder höher nutzbar und ersetzt die Extension [[EXT_histogram]].

'''glHistogram''' ist nur verfügbar, wenn '''GL_ARB_imaging''' von [[glGetString]] mit dem Argument '''GL_EXTENSIONS''' zurückgeliefert wird.

Der Höchstwert für den Parameter ''width'' ist implementierungsabhängig, muß aber mindestens 32 sein.

Histogramme können nur auf RGBA-Komponenten angewendet werden.

== Fehlermeldungen ==
'''GL_INVALID_ENUM''' wird generiert, wenn ''target'' keinen der zulässigen Werte hat.

'''GL_INVALID_ENUM''' wird generiert, wenn ''internalformat'' keinen der zulässigen Werte hat.

'''GL_INVALID_VALUE''' wird generiert, wenn ''width'' kleiner als 0 ist oder nicht vom Typ 2^n (n: Integer) ist.

'''GL_INVALID_VALUE''' wird generiert, wenn ''sink'' weder den Wert '''GL_TRUE''' noch '''GL_FALSE''' hat.

'''GL_TABLE_TOO_LARGE''' wird generiert, wenn das angeforderte Histogramm zu groß und ''target'' auf '''GL_HISTOGRAM''' gesetzt ist.

'''GL_INVALID_OPERATION''' wird generiert, wenn '''glHistogram''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.

<br>

== Zugehörige Wertrückgaben ==
[[glGetHistogramParameter]]

== Siehe auch ==
[[glGetHistogram]], [[glResetHistogram]]

[[Kategorie:GL|Histogram]]

@@ Zeile 29: / Zeile 29: @@
 == Beschreibung ==
 Wenn '''GL_HISTOGRAM''' aktiviert ist, werden die RGBA-Farbkomponeten zu Histogramm-Tabellenindizes durch Mapping auf den Bereich [0, 1] konvertiert, mit der Breite der Histogramm-Tabelle multipliziert und auf den nächsten Integer-Wert gerundet. Die durch die RGBA-Indizes ausgewählten Tabelleneinträge werden dann erhöht. (Falls das interne Format der Histogramm-Tabelle die Helligkeits-Komponente enthält, bestimmt der von der R-Farbkomponente abgeleitete Index den zu erhöhenden Helligkeits-Tabelleneintrag.) Falls ein Histogramm-Tabelleneintrag über seinen Maximalwert erhöht wird, wird sein Wert undefiniert (Dies ist kein Fehler.)
@@ Zeile 38: / Zeile 39: @@
 <br>
 == Hinweise ==
 '''glHistogram''' ist erst ab GL Version 1.2 oder höher nutzbar.

@@ Zeile 69: / Zeile 69: @@
 == Siehe auch ==
 [[glGetHistogram]], [[glResetHistogram]]
 [[Kategorie:GL|Histogram]]

@@ Zeile 1: / Zeile 1: @@
 = glHistogram =
-<br>
 == Name ==
 '''glHistogram''' - definiert eine [[Histogramm]]-Tabelle.
@@ Zeile 44: / Zeile 45: @@
 Der Höchstwert für den Parameter ''width'' ist implementierungsabhängig, muß aber mindestens 32 sein.
-<br>
 == Fehlermeldungen ==
 '''GL_INVALID_ENUM''' wird generiert, wenn ''target'' keinen der zulässigen Werte hat.
@@ Zeile 58: / Zeile 60: @@
 '''GL_INVALID_OPERATION''' wird generiert, wenn '''glHistogram''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
-<br>
 == Zugehörige Wertrückgaben ==
 [[glGetHistogramParameter]]

@@ Zeile 3: / Zeile 3: @@
 <br>
 == Name ==
-'''glHistogram''' - definiert, wie die Daten eines Histogramms gespeichert werden sollen.
+'''glHistogram''' - definiert eine [[Histogramm]]-Tabelle.
 == Delphi-Spezifikation ==
-  procedure '''glHistogram'''(''target'' : TGLenum; ''width'' : TGLsizei; ''internalformat'' : TGLenum;
+  procedure '''glHistogram'''(''target'' : TGLenum; ''width'' : TGLsizei;
-                       ''sink'' : TGLboolean)
+                       ''internalformat'' : TGLenum; ''sink'' : TGLboolean)
@@ Zeile 15: / Zeile 15: @@
 {| border="1" rules="all"
 ! ''target''
-| Muss einer der folgenden Konstanten sein:  '''GL_HISTROGRAM''' oder '''GL_PROXY_HISTOGRAM'''.
+| Das Histogramm, dessen Parameter gesetzt werden. Muss einer der folgenden Konstanten sein:  '''GL_HISTROGRAM''' oder '''GL_PROXY_HISTOGRAM'''.
 |-
 ! ''width''
@@ Zeile 24: / Zeile 24: @@
 |-
 ! ''sink''
-| Flag, ob die Pixel nach der Histogramm-Operation in den nächsten Prozess der [[Imaging Pipeline]] geschickt werden sollen ([[glMinmax]]).
+| Falls '''GL_TRUE''', werden die Pixel durch den Histogramm-Prozess zerstört und es findet kein Zeichnen oder Laden einer Textur statt. Falls '''GL_FALSE''', werden die Pixel nach dem Histogramm-Schritt zum Minmax-Prozess weitergeleitet.
 |}
 == Beschreibung ==
-'''glHistogram''' kann für zwei Methoden verwendet werden: Ist ''target'' auf '''GL_PROXY_HISTOGRAM''' gesetzt, so wird geprüft, ob genügend Ressourcen zur Verfügung stehen, um intern ein Histogramm mit der angegebenen Grösse, dem Format und der Auflösung abzuspeichern.
+Wenn '''GL_HISTOGRAM''' aktiviert ist, werden die RGBA-Farbkomponeten zu Histogramm-Tabellenindizes durch Mapping auf den Bereich [0, 1] konvertiert, mit der Breite der Histogramm-Tabelle multipliziert und auf den nächsten Integer-Wert gerundet. Die durch die RGBA-Indizes ausgewählten Tabelleneinträge werden dann erhöht. (Falls das interne Format der Histogramm-Tabelle die Helligkeits-Komponente enthält, bestimmt der von der R-Farbkomponente abgeleitete Index den zu erhöhenden Helligkeits-Tabelleneintrag.) Falls ein Histogramm-Tabelleneintrag über seinen Maximalwert erhöht wird, wird sein Wert undefiniert (Dies ist kein Fehler.)
-Die Ergebnisse des Proxy-Kommandos können mit [[glGetHistogramParameter]] abgefragt werden.
+[[Histogramm|Histogramme]] werden nur für RGBA-Pixel ausgeführt (auch wenn diese ursprünglich als Color-Indizes definiert und ins RGBA-Format durch Indextabellen-Lookup konvertiert wurden). Histogramme werden mit [[glEnable]] aktiviert und mit [[glDisable]] dekaktiviert.
-Übergibt man '''GL_HISTOGRAM''' an ''target'', werden die Parameter für das Histogramm gesetzt.
+Wenn ''target'' '''GL_HISTOGRAM''' ist, definiert [[glHistogram]] die aktuelle Histogramm-Tabelle mit ''width'' Einträgen des durch ''internalformat'' angegebenen Formats. Die Einträge werden von 0 bis ''width'' - 1 indiziert und alle Einträge werden mit 0 initialisiert. Die Werte in der vorherigen Histogramm-Tabelle, falls welche existierten, gehen verloren. Falls ''sink'' '''GL_TRUE''' ist, werden die Pixel nach der Histogramm-Operation aufgegeben; keine weiteren Pixelverarbeitungen finden statt und kein Zeichnen, Texturladen oder Zurücklesen von Pixel wird darauf folgen.
 == Hinweise ==
 '''glHistogram''' ist erst ab GL Version 1.2 oder höher nutzbar.
@@ Zeile 50: / Zeile 44: @@
 Der Höchstwert für den Parameter ''width'' ist implementierungsabhängig, muß aber mindestens 32 sein.
-Histogramme können nur auf RGBA-Komponenten angewendet werden.
+<br>
 == Fehlermeldungen ==
 '''GL_INVALID_ENUM''' wird generiert, wenn ''target'' keinen der zulässigen Werte hat.
@@ Zeile 66: / Zeile 59: @@
 <br>
 == Zugehörige Wertrückgaben ==
 [[glGetHistogramParameter]]

@@ Zeile 44: / Zeile 44: @@
 == Hinweise ==
-'''glDrawElements''' ist erst ab GL Version 1.2 oder höher nutzbar und ersetzt die Extension [[EXT_histogram]].
+'''glHistogram''' ist erst ab GL Version 1.2 oder höher nutzbar.
 '''glHistogram''' ist nur verfügbar, wenn '''GL_ARB_imaging''' von [[glGetString]] mit dem Argument '''GL_EXTENSIONS''' zurückgeliefert wird.

@@ Zeile 18: / Zeile 18: @@
 |-
 ! ''width''
-| Anzahl der Einträge des Histogramms. Muss eine Zahl vom Typ 2^n (n: Integer) sein.
+| Anzahl der Einträge des Histogramms. Muss eine Zahl vom Typ 2^n (n: Integer) sein. (2,4,8,16,...)
 |-
 ! ''internalformat''
@@ Zeile 26: / Zeile 26: @@
 | Flag, ob die Pixel nach der Histogramm-Operation in den nächsten Prozess der [[Imaging Pipeline]] geschickt werden sollen ([[glMinmax]]).
 |}
 == Beschreibung ==