From e086f2c148f7b00ae1d7046eca5c9385c3763acf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20Dr=C3=B6ge?= <slomo@circular-chaos.org>
Date: Sun, 11 Nov 2007 12:54:31 +0000
Subject: [PATCH] gst/equalizer/: Update docs and property ranges to the real
 values.

Original commit message from CVS:
* gst/equalizer/gstiirequalizer10bands.c:
(gst_iir_equalizer_10bands_class_init):
* gst/equalizer/gstiirequalizer3bands.c:
(gst_iir_equalizer_3bands_class_init):
* gst/equalizer/gstiirequalizernbands.c:
Update docs and property ranges to the real values.
---
 ChangeLog                              |  9 ++++++
 gst/equalizer/gstiirequalizer10bands.c | 42 +++++++++++++-------------
 gst/equalizer/gstiirequalizer3bands.c  | 17 +++++------
 gst/equalizer/gstiirequalizernbands.c  |  2 +-
 4 files changed, 39 insertions(+), 31 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b47cd38a5f..39ab9160be 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2007-11-11  Sebastian Dröge  <slomo@circular-chaos.org>
+
+	* gst/equalizer/gstiirequalizer10bands.c:
+	(gst_iir_equalizer_10bands_class_init):
+	* gst/equalizer/gstiirequalizer3bands.c:
+	(gst_iir_equalizer_3bands_class_init):
+	* gst/equalizer/gstiirequalizernbands.c:
+	Update docs and property ranges to the real values.
+
 2007-11-09  Sebastian Dröge  <slomo@circular-chaos.org>
 
 	* gst/spectrum/gstspectrum.c:
diff --git a/gst/equalizer/gstiirequalizer10bands.c b/gst/equalizer/gstiirequalizer10bands.c
index 785a34526a..a2e2018f8a 100644
--- a/gst/equalizer/gstiirequalizer10bands.c
+++ b/gst/equalizer/gstiirequalizer10bands.c
@@ -27,7 +27,7 @@
  * </para>
  * <para>
  * <programlisting>
- * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-10bands band2=0.5 ! alsasink
+ * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-10bands band2=3.0 ! alsasink
  * </programlisting>
  * This raises the volume of the 3rd band which is at 119 Hz by 3 db.
  * </para>
@@ -92,44 +92,44 @@ gst_iir_equalizer_10bands_class_init (GstIirEqualizer10BandsClass * klass)
 
   g_object_class_install_property (gobject_class, ARG_BAND0,
       g_param_spec_double ("band0", "29 Hz",
-          "gain for the frequency band 29 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 29 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND1,
       g_param_spec_double ("band1", "59 Hz",
-          "gain for the frequency band 59 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 59 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND2,
       g_param_spec_double ("band2", "119 Hz",
-          "gain for the frequency band 119 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 119 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND3,
       g_param_spec_double ("band3", "227 Hz",
-          "gain for the frequency band 227 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 227 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND4,
       g_param_spec_double ("band4", "474 Hz",
-          "gain for the frequency band 474 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 474 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND5,
       g_param_spec_double ("band5", "947 Hz",
-          "gain for the frequency band 947 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 947 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND6,
       g_param_spec_double ("band6", "1889 Hz",
-          "gain for the frequency band 1889 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 1889 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND7,
       g_param_spec_double ("band7", "3770 Hz",
-          "gain for the frequency band 3770 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 3770 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND8,
       g_param_spec_double ("band8", "7523 Hz",
-          "gain for the frequency band 7523 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 7523 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND9,
       g_param_spec_double ("band9", "15011 Hz",
-          "gain for the frequency band 15011 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 15011 Hz, ranging from -24 dB to +12 dB",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
 }
 
 static void
diff --git a/gst/equalizer/gstiirequalizer3bands.c b/gst/equalizer/gstiirequalizer3bands.c
index 08a1dfacfa..e2229dd7ae 100644
--- a/gst/equalizer/gstiirequalizer3bands.c
+++ b/gst/equalizer/gstiirequalizer3bands.c
@@ -27,7 +27,7 @@
  * </para>
  * <para>
  * <programlisting>
- * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-3bands band1=1.0 ! alsasink
+ * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-3bands band1=6.0 ! alsasink
  * </programlisting>
  * This raises the volume of the 2nd band which is at 1110 Hz by 6 db.
  * </para>
@@ -41,7 +41,6 @@
 #include "gstiirequalizer.h"
 #include "gstiirequalizer3bands.h"
 
-
 enum
 {
   ARG_BAND0 = 1,
@@ -85,16 +84,16 @@ gst_iir_equalizer_3bands_class_init (GstIirEqualizer3BandsClass * klass)
 
   g_object_class_install_property (gobject_class, ARG_BAND0,
       g_param_spec_double ("band0", "110 Hz",
-          "gain for the frequency band 110 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 100 Hz, ranging from -24.0 to +12.0",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND1,
-      g_param_spec_double ("band1", "1110 Hz",
-          "gain for the frequency band 1110 Hz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+      g_param_spec_double ("band1", "1100 Hz",
+          "gain for the frequency band 1100 Hz, ranging from -24.0 to +12.0",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
   g_object_class_install_property (gobject_class, ARG_BAND2,
       g_param_spec_double ("band2", "11 kHz",
-          "gain for the frequency band 11 kHz, ranging from -1.0 to +1.0",
-          -1.0, 1.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
+          "gain for the frequency band 11 kHz, ranging from -24.0 to +12.0",
+          -24.0, 12.0, 0.0, G_PARAM_READWRITE | GST_PARAM_CONTROLLABLE));
 }
 
 static void
diff --git a/gst/equalizer/gstiirequalizernbands.c b/gst/equalizer/gstiirequalizernbands.c
index a3401b3357..164dca5cd6 100644
--- a/gst/equalizer/gstiirequalizernbands.c
+++ b/gst/equalizer/gstiirequalizernbands.c
@@ -28,7 +28,7 @@
  * </para>
  * <para>
  * <programlisting>
- * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-nbands num-bands=15 band5::gain=1.0 ! alsasink
+ * gst-launch filesrc location=song.ogg ! oggdemux ! vorbisdec ! audioconvert ! equalizer-nbands num-bands=15 band5::gain=6.0 ! alsasink
  * </programlisting>
  * This make the equalizer use 15 bands and raises the volume of the 5th band by 6 db.
  * </para>