examples/level/README

   1 level plugin by thomas <thomas@apestaart.org>
   2
   3 this plugin signals:
   4   - running time since last EOS/start
   5   - channel
   6   - RMS level
   7   - peak level
   8   - decaying peak level
   9 over the given interval.
  10
  11 This is useful for a VU meter display and for plotting out the signal graph.
  12 The VU meter can either display RMS, or display immediate peak level and
  13 have the falloff decaying peak level displayed as a line.
  14
  15 The interval for signal emission, ttl of decay peak, and falloff of decay peak
  16 can all be set.
  17
  18 The element only takes unsigned data in; it could be extended to signed as
  19 well, if separate fast chain functions are made that displaces the incoming
  20 data to its midpoint (ie, 0,65535 should be mapped to -32768, 32767)
  21
  22 There are two demo apps, apps and plot.  apps will create some GTK sliders
  23 to display the volume.  plot will output data readable by gnuplot.
  24
  25 Here is a sample plot script to plot output of the plot command that was
  26 stored to plot.dat
  27
  28 set xlabel "Seconds"
  29 set ylabel "dB"
  30 set yrange [-60:0]
  31 plot 'plot.dat' using 1:2 title 'L RMS' with lines, \
  32      'plot.dat' using 1:3 title 'L peak' with lines, \
  33      'plot.dat' using 1:4 title 'L decay' with lines
  34
  35 plot 'plot.dat' using 1:5 title 'R RMS' with lines, \
  36      'plot.dat' using 1:6 title 'R peak' with lines, \
  37      'plot.dat' using 1:7 title 'R decay' with lines
  38
  39