Refpitch 1.02 
-------------
by Grekim Jennings

New in version 1.02 is the ability to export to a wave file, adjust the
cents, adjustable samplerate, and the ability set the level when using command 
line arguments.  


Refpitch is a command line application that plays a note or frequency of your 
choice for accurate instrument tuning or making test tones.  The program may 
be run with up to four command line arguments: The first argument is the 
frequency in Hertz, the second is the time in seconds, the third is the
soundcard device name (see below), and the fourth is the level (from 0 to 100).  

If no command arguments are used, the program runs in interactive mode where
more features are available. For example, you can enter the letter name of a 
note, such as c or c#, and adjust the octave and cents.

Also in interactive mode, you can enter G1, G2, etc for guitar string 1 and
guitar string 2, etc.  Or, for bass guitar enter B1, B2, etc.  

Important:
1.  When run using command line arguments, the program only understands the
frequency you enter, not letter "notes".  
2.  In interactive, you can think of the program as being able to switch
between understanding notes or a frequency.  The octave and the cents only
affect the sound when you enter a note.  So, when you use the 'z' command
to enter a specific frequency, it is not affected by the cents or octave
settings. 

The scale used is the equal temperament scale.  By defaut, the program requests
a sample rate of 44,100 Hz, but if the soundcard does not comply then the
program will alert you.  An incorrect sample rate would result in the wrong
frequency being played back.  You can change the samplerate in 
interactive mode.     

The device name of the soundcard defaults to 'default'.  If using the default 
setting does not produce sound or the desired soundcard, try using plughw:0,0 
or plughw:1,0 for card 0 or card 1 as indicated by running aplay -l.

You can export to a 24-bit wave file using the 'exp' command in interactive
mode.  This is a very clean high-resolution file.