wmscope Copyright (C) 1998 John Meacham
http://synergy.foo.net/~john/

wmscope is liscenced under the GNU Public Licsence version 2 
see file COPYING for details.

this is a simple dockable scope that reads in the sound card data
(from the line in or cd) and displays it graphically. or as a neat
looking alternative it will display a sine wave interference pattern
it is meant to be used with windowmaker or afterstep as a docked applet.
you click on it to open or close the audio device.

this is release 2. see CHANGES for details.

questions:

how do i get a list of options?
	wmscope -h

how do i dock under WindowMaker?
	use the -w option

the sine waves keep going when i click on it!
	it cant open the sound card, look on console output (stderr)

the display is just a flat line (no audio signal.)
	your mixer is probably set wrong. open your favorite mixer
and make sure it is set to listen to the cd or line in properly
and that the input gain is set high enough.

signal is too strong!
	see above.

you can also use the '-a' switch with a number to amplify or 
diminish the signal before it is displayed.

signal is chunky.. lags behind sound or something..
try modifying the sample rate and arg to the setformat ioctl where 
wmscope opens the audio device... this is soundcard dependant and ymmv.


usage:

   wmscope [options]

options:

   -h | -help | --help    display this help screen
   -w                     use WithdrawnState    (for WindowMaker)
   -s                     shaped window
   -l led_color           use the specified color for led displays
   -b back_color          use the specified color for backgrounds
   -a amp_factor          signal amplification factor (2 = 2x)
   -d dsp_dev             use specified device  (rather than /dev/dsp)
   -c                     read sound data from stdin.(raw 8bit unsigned)
   -display display       select target display (see X manual pages)



hope you enjoy!
	John


