summaryrefslogtreecommitdiffstats
path: root/examples/level/README
diff options
context:
space:
mode:
authorAndy Wingo <wingo@pobox.com>2005-07-04 14:02:46 +0000
committerAndy Wingo <wingo@pobox.com>2005-07-04 14:02:46 +0000
commit2d199737c163bb70adbd6da5a8abeea1ba90aaf9 (patch)
tree90c608eaf2d956b0d27be9a3e159cfb1312ecfa3 /examples/level/README
parentfcfad33d4a80287684ae7d5809b743d38e5d4fe6 (diff)
downloadgst-plugins-bad-2d199737c163bb70adbd6da5a8abeea1ba90aaf9.tar.gz
gst-plugins-bad-2d199737c163bb70adbd6da5a8abeea1ba90aaf9.tar.bz2
gst-plugins-bad-2d199737c163bb70adbd6da5a8abeea1ba90aaf9.zip
examples/level/: Examples moved out of the source dir. Not updated tho.
Original commit message from CVS: 2005-07-04 Andy Wingo <wingo@pobox.com> * examples/level/: * examples/level/Makefile.am: * examples/level/README: * examples/level/demo.c: * examples/level/plot.c: Examples moved out of the source dir. Not updated tho. * configure.ac: Add level to the build. * gst/level/Makefile.am: * gst/level/gstlevel.h: * gst/level/gstlevel.c: Cleaned up, ported to 0.9.
Diffstat (limited to 'examples/level/README')
-rw-r--r--examples/level/README39
1 files changed, 39 insertions, 0 deletions
diff --git a/examples/level/README b/examples/level/README
new file mode 100644
index 00000000..0ae84188
--- /dev/null
+++ b/examples/level/README
@@ -0,0 +1,39 @@
+level plugin by thomas <thomas@apestaart.org>
+
+this plugin signals:
+ - running time since last EOS/start
+ - channel
+ - RMS level
+ - peak level
+ - decaying peak level
+over the given interval.
+
+This is useful for a VU meter display and for plotting out the signal graph.
+The VU meter can either display RMS, or display immediate peak level and
+have the falloff decaying peak level displayed as a line.
+
+The interval for signal emission, ttl of decay peak, and falloff of decay peak
+can all be set.
+
+The element only takes unsigned data in; it could be extended to signed as
+well, if separate fast chain functions are made that displaces the incoming
+data to its midpoint (ie, 0,65535 should be mapped to -32768, 32767)
+
+There are two demo apps, apps and plot. apps will create some GTK sliders
+to display the volume. plot will output data readable by gnuplot.
+
+Here is a sample plot script to plot output of the plot command that was
+stored to plot.dat
+
+set xlabel "Seconds"
+set ylabel "dB"
+set yrange [-60:0]
+plot 'plot.dat' using 1:2 title 'L RMS' with lines, \
+ 'plot.dat' using 1:3 title 'L peak' with lines, \
+ 'plot.dat' using 1:4 title 'L decay' with lines
+
+plot 'plot.dat' using 1:5 title 'R RMS' with lines, \
+ 'plot.dat' using 1:6 title 'R peak' with lines, \
+ 'plot.dat' using 1:7 title 'R decay' with lines
+
+