debian/gentones.1

   1 .TH GENTONES 1
   2 .SH NAME
   3 gentones \- generates tones
   4 .SH SYNOPSIS
   5 gentone wave2alaw <wav file> <alaw file>
   6 .br
   7 gentone wave2ulaw <wav file> <ulaw file>
   8 .br
   9 gentone tone2alaw <frq1> <frq2> <length> <fade in> <fade out> <alaw file>
  10 .br
  11 gentone tone2ulaw <frq1> <frq2> <length> <fade in> <fade out> <ulaw file>
  12 .SH DESCRIPTION
  13 Length and fade lengths must be given in samples (8000 samples are one second).
  14 Tones will append to existing files, wav files don't.
  15 Frequencies may be given as floating point values.
  16 .br
  17 It can be used, to generate law encoded tones with one or two frequencies.
  18 This is mainly used to create patterns, like dial tones, busy tone and other audio
  19 patterns. Depending on your telephone system, you need to use "tones2alaw" or "tones2ulaw".
  20 There are two frequencies to specify "frq1" and "frq2". If only one frequency should be
  21 used, enter 0 for "frq2". The "length" specifies the total length of the tone in samples. 8000
  22 samples are one second. 2000 samples are 1/4 of a second. "fade in" and "fade out" is used to
  23 make the start and stop of the tone soft. If "fade in" is 800, the sound will fade in
  24 within 1/10 of a second.
  25 This makes tones very smooth and avoids the ‘click’ sound at the beginning.
  26 "fade out" respectively. Whatever specified for "fade in" and "fade out", the tone will
  27 be as long as given at "length". If you don’t want to use fades, set "frq1" and "frq2" to
  28 "0". I suggest at least 50 sample for fade to silence.
  29 .br
  30 The given file will be appended to "alaw file" or "ulaw file". If you like
  31 to create a new one, but the name still exist, delete the file and then start creating it. This
  32 is useful to create a sample with more than one tone. Example: A busy tone normally is made out of
  33 1/2 second of a tone, and one 1/2 second of silence. To add silence, just enter 0 for "frq1"
  34 and "frq2".
  35 .br
  36 It is also possible to convert a wave file to a-law or mu-law. The wave file
  37 must have a sampling rate of 8000. It doesn’t matte what bit-resolution or how many
  38 channels it has (stereo or mono). The sampling rate will not be converted, so it must be
  39 8000 samples/second. The resolution should be 16 bits for best quality. a-law and
  40 mu-law have better resolution than 8 bits. The data of a-law and mu-law is 8 bits
  41 sample, but since it is quantised, the quality will be 12 bits. 12 bits sounds almost as good as 16
  42 bits. Wave files are only available with 8 or 16 bits resolution.
  43 .br
  44 The use of a-law or mu-law files, result in a faster processing, since the
  45 samples must not be converted into a-law or mu-law for ISDN use. ISDN uses only a-law or mu-law
  46 samples.
  47 .SH SEE ALSO
  48 http://www.linux-call-router.de/doc.html
  49 .SH AUTHOR
  50 This minimal man page was written by Victor Seva
  51 <linuxmaniac@torreviejawireless.org>
  52 .br
  53 from documentation created by Andreas Eversberg <jolly@eversberg.eu>