changeset 11391:d83dedaff4d4

eq2 gamma weight doku by (Alexander Stege <mplayer at legale-software dot com>)

--- a/DOCS/man/de/mplayer.1	Tue Nov 04 20:05:47 2003 +0000
+++ b/DOCS/man/de/mplayer.1	Tue Nov 04 21:51:39 2003 +0000
@@ -2144,20 +2144,25 @@
 Aktiviert den Softwareequalizer mit interaktiver Kontrolle wie der
 Hardware\-EQ\-Kontrolle.
 Die Werte können zwischen -100 und 100 liegen.
-.IPs eq2[=gamma:Kontrast:Helligkeit:Sättigung:rg:gg:bg]
+.IPs eq2[=gamma:Kontrast:Helligkeit:Sättigung:rg:gg:bg:weight]
 Alternativer Softwareequalizer, der Lookup-Tabellen benutzt (sehr langsam).
 Er erlaubt neben simpler Anpassung der Helligkeit, des Kontrastes und der
-Sättigung auch eine Gammakorrektur. Beachte, dass er den gleichen
-MMX-optimierten Code benutzt wie der eq-Filter, wenn alle Gammawerte 1.0
+Sättigung auch eine Gammakorrektur.
+Der Parameter weight kann verwendet werden, um die Wirkung hoher gamma
+Werte auf helle Bildbereiche zu reduzieren, sie also davon abzuhalten
+zu übersteuern und ganz weiss zu werden. Bei 0.0 hat die Gammakorrektur gar
+keinen Effekt mehr, bei 1.0 hat sie die volle Stärke.
+Beachte, dass er den gleichen MMX-optimierten Code benutzt wie der 
+eq-Filter, wenn alle Gammawerte 1.0
 betragen!
 Die Parameter werden als Fließkommazahlen angegeben.
-Standardwerte sind gamma=1.0, Kontrast=1.0, und Helligkeit=0.0 und
-Sättigung=1.0. Die Parameter rg, gg, bg sind unabhängige Gammawerte für
-die einzelnen Farbkomponenten Rot, Grün und Blau. Alle drei sind standardmäßig
-auf 1.0.
+Standardwerte sind gamma=1.0, Kontrast=1.0, und Helligkeit=0.0,
+Sättigung=1.0 und weight=1.0. Die Parameter rg, gg, bg sind unabhängige 
+Gammawerte für die einzelnen Farbkomponenten Rot, Grün und Blau. Alle drei 
+sind standardmäßig auf 1.0.
 Die Wertebereiche betragen 0.1\-10 für gamma, -2\-2 für Kontrast (negative
-Werte invertieren das Bild), -1\-1 für die Helligkeit und 0\-3 für die
-Sättigung.
+Werte invertieren das Bild), -1\-1 für die Helligkeit, 0\-3 für die
+Sättigung und 0\-1 für weight.
 .IPs halfpack[=f]
 Konvertiert planaeres YUV 4:2:0 in halbhohes, gepacktes 4:2:2, wobei
 die Helligkeit runtergesamplet und der Farbanteil beibehalten wird.

--- a/DOCS/man/en/mplayer.1	Tue Nov 04 20:05:47 2003 +0000
+++ b/DOCS/man/en/mplayer.1	Tue Nov 04 21:51:39 2003 +0000
@@ -2725,7 +2725,7 @@
 with lower bitrates.
 Initial values in the range -100\-100 may be given on the command line.
 .TP
-.B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg]
+.B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
 Alternative software equalizer that uses lookup tables (very slow),
 allowing gamma correction in addition to simple brightness
 and contrast adjustment.
@@ -2734,9 +2734,13 @@
 The parameters are given as floating point values.
 Parameters rg, gg, bg are the independent gamma values for the Red, Green
 and Blue components.
-Defaults are 1.0, brightness=0.0.
+The weight parameter can be used to reduce the effect of a high gamma value on
+bright image areas, e.g. keep them from getting overamplified and just plain
+white. A value of 0.0 turns the gamma correction all the way down while 1.0 
+leaves it at its full strength.
+Defaults are contrast=1.0, brightness=0.0, gammas=1.0, saturation=1.0, weight=1.0.
 Value ranges are 0.1\-10 for gammas, -2\-2 for contrast (negative values result
-in a negative image), -1\-1 for brightness and 0\-3 for saturation.
+in a negative image), -1\-1 for brightness, 0\-3 for saturation and 0\-1 for weight.
 .TP
 .B hue[=hue:saturation]
 Defaults are hue=0.0, saturation=1.0.