1README file for dtmf-dial-0.1
2
3(C) 1998 Itai Nahshon, nahshon@actcom.co.il
4Use and redistribution are subject to the GNU GENERAL PUBLIC LICENSE.
5
6
7Dial generates the dtmf tone signals used for telephone
8dialing and by default sends the signals to the sound card.
9
10It can be used for easy dialing, simply put the telephone
11microphone near the compiter speaker and let the software
12dial for you.
13
14It is intended for dialing from within data base programs that
15also store telephone numbers.
16
17Usage:
18Usually you just run need to give the phone number
19that you wish to dial as an argument.
20    dial 555-3456
21
22By default the tone generated for each dialed digit is
23100 milliseconds. Silence between digits is 50 milliseconds.
24A comma or a blank space between digits is replaces with
25a 500 milliseconds delay.
26
27The duration values can be set by these arguments:
28  --tone-time   milliseconds 	(default 100)
29  --silent-time milliseconds	(default 50)
30  --sleep-time  milliseconds	(default 500)
31
32By default the output is sent to "/dev/dsp". Generated samples
33are 8 bits unsigned values (AFMT_U8). 8000 samples/second.
34
35To send the output to another device one can use the option:
36  --output-dev device		(default /dev/dsp)
37This option can be used also to store raw audio samples to
38a file, or to stdout. Use the file name with the --output-dev
39option, ir a simpe "-" to sent to stdout.
40If the output device is not the sound special file then another
41option should be used to eliminate attempts to set the sound
42driver parameters:
43  --use-audio  onoff	(default 1)
44Use "--use-audio 0" to disable sound ioctls.
45
46It is possible to generate the samples in AFMT_S16_LE format,
47To do that use the option:
48  --bits  bits-per-sample  (default 8)
498 will geneate AFMT_U8 format, 16 will generate AFMT_S16_LE format.
50
51It is possible to generate samples in a different sampling rate.
52To do that use the option:
53  --speed sampling-rate    (default 8000)
54
55Sound samples are generated by sub-sampling values from a cosine
56table. By default the cosine table contains 256 samples.
57Smaller cosine table sizes still produce the correct frequencies
58but with some distortion.
59These options can be used:
60  --table-size size		(default 256)
61The table used is of a different size
62  --volume volume		(default 100)
63Values stored in the table are scaled down volume/100 times
64the maximum value which does not cause overflow on the 8 or
6516 bit samples.
66
67To generate a stereo sound use the options --right or
68--left. By default they are 0 and a mono sample is generated.
69If any of these option are 1, a stereo sample will be generated
70and the corrensponding channel will be turned on.
71