autools autools-1.2.4 ============= Contents ======== Contents ABOUT autools Install The AFsp Audio File I/O Package Usage plax -- play and record audio on Linux/Solaris/IRIX/Win32 auquery -- query audio device capabilities playlist -- play list of audio files (and query listeners gradings) randhead -- add random number as first column catcol -- concatenate two files as columns augen -- generate tones/noise according to "*.gen" script genfm -- generate sine with triangular freq. mod. genam -- generate sine with triangular ampl. mod. auquant -- very simple quantiser & noise-shaper ac3spdif -- encapsulates AC3 in S/P-DIF according to IEC 61937 auduplex -- au record & play (duplex, for Linux) fifo -- fifo for use with mkfifo and auduplex other tools and files ABOUT autools ============= (c) Heiko Purnhagen 1993-2003 e-mail: purnhage@tnt.uni-hannover.de WWW: http://www.tnt.uni-hannover.de/~purnhage/ Version autools-1.2.4 ($Id: gen-html,v 1.13 2003/01/19 23:24:09 purnhage Exp $) autools homepage: http://www.tnt.uni-hannover.de/~purnhage/software/autools/ All usual disclaimers apply! The programs in this package are available under the terms of the GNU General Public Licence. See file COPYING for further details. The modules in this package are available under the terms of the GNU Lesser General Public License. See file COPYING-LGPL for further details. Acknowledgements: MPEG-4 Audio VM authors for comments on common.c, cmdline.c, and audio.c Bernd Edler for the initial playlist software (also as base for for playrec.c) Nikolaus Meine for code used in austream.c and the highly optimised rateconv.c Lampos Ferekidis for porting autools to MSVC and Cygwin Peter Kabal for the AFsp package (including libtsp) David Viens for providing a modified version of the rateconv module for use as DLL Authors: HP Heiko Purnhagen, Uni Hannover NM Nikolaus Meine, Uni Hannover Changes: 20-dec-98 HP README born 30-dec-98 HP CVS, refined many files ... 17-jan-99 HP updated to autools-0.3 26-jan-99 HP updated to autools-0.4 28-jan-99 HP updated to autools-0.4.2 29-jan-99 HP updated to autools-0.5 18-feb-99 HP updated to autools-0.5.1 06-aug-99 HP updated to autools-0.6 04-nov-99 HP updated to autools-0.7 11-nov-99 HP updated to autools-0.7.1 19-nov-99 HP updated to autools-0.7.2 28-dec-99 HP autools-0.8, fixed bug in plax recording 16-feb-00 HP updated to autools-0.8.1, several extensions of plax 17-mar-00 HP updated to autools-0.8.2, several extensions of plax 06-jun-00 HP updated to autools-0.9.0, added auduplex, fifo 07-jun-00 HP updated to autools-0.9.1, fixed plax hangup / playrec.c 06-sep-00 HP updated to autools-0.9.2 26-Nov-2001 HP not yet fully updated to autools-1.1.2 ... 06-Feb-2002 HP updated to autools-1.1.5, automatic HTML documentation ... 08-Mar-2002 HP added wav2toc 11-Apr-2002 HP added ac3spdif 2003-01-19 HP added GPL/LGPL (c) headers, added rateconv-dll Install ======= Compile: make Install: make install or make install INSTALL_DIR=/usr/local/bin Most of this software utilises AFsp's libtsp for audio file i/o. Thus libtsp needs to be available in the default include & library paths or in the directories given by the environment variables AFSP_INCLUDE_PATH and AFSP_LIBRARY_PATH. Further details about AFsp are given below. This software can also be compiled without AFsp's libtsp library - in this case, only 16-bit SUN "*.au"-files are supported: make clean make USE_AFSP=0 The makefile assumes gcc/g++ and GNU make. It was successfully tested on Linux, Solaris, and IRIX. However it might be necessary to adapt it to your local environment ... The AFsp Audio File I/O Package ------------------------------- To provide support for a variety of audio file formats, this software can use the AFsp package for audio file i/o. The AFsp package is written by Peter Kabal and is available by ftp: WWW site: http://www.tsp.ece.mcgill.ca/Docs/Software/AFsp/AFsp.html ftp site: ftp://ftp.TSP.ECE.McGill.CA/TSP/AFsp/ mirror site: ftp://ftp.tnt.uni-hannover.de/pub/audio/AFsp This software has been tested with the AFsp versions AFsp-V3R2.tar.Z, AFsp-v4r1.tar.gz, AFsp-v4r2.tar.gz, AFsp-v4r3.tar.gz, AFsp-v5r2.tar.gz, AFsp-v6r4.tar.gz and AFsp-v6r5a.tar.gz. To make the libtsp library required by this software, unpack AFsp-v4r3.tar.gz, goto AFsp-v4r3/libtsp, and start make. Then you can install the content of ../include and ../lib on your system (e.g. in /usr/local/include and /usr/local/lib) or set the environment variables AFSP_INCLUDE_PATH and AFSP_LIBRARY_PATH to point to the proper AFsp directories. Usage ===== plax -- play and record audio on Linux/Solaris/IRIX/Win32 --------------------------------------------------------- plax: plax V1.2.4 09-Dec-2003 autools-1.2.4 $Id: plax.c,v 1.52 2003/12/09 04:06:17 purnhage Exp $ all AFsp file formats supported usage: plax -switches switches: -h print help -o output file name (- = stdout) (dflt: audio device) -of output file format (au/wav/aiff/raw/be/le) (16 bit, raw/be: big-endian raw, le: little-endian raw) (dflt: as file extension or au for stdout) -if input file format (AFsp: auto/raw/be/le ..., see also -ia -f xxx) (16 bit au/raw: auto/au/raw/be/le, see also -is) (dflt: auto) -is header bytes to skip if raw input (not AFsp) (dflt: 0) -ia stdin using AFsp (dflt: 16 bit au/raw) -oa stdout using AFsp, needs -of xxx (dflt: 16 bit au/raw) -f raw input file format (AFsp) (dflt: $RAWAUDIOFILE / "integer16,0,48000.,native,1,1.0") -c output: number of channels (dflt: as input or 1) -s output: sampling frequency [Hz] (dflt: as input or 8000.0) -rc rec: number of channels (SGI: 0 = use audio panel settings) (dflt: as output) -rs rec: sampling frequency [Hz] (SGI: 0 = use audio panel settings) (dflt: as output) -pd play: audio device name (dflt: default device) -rd rec: audio device name (dflt: default device) -df max. tolerated relative sampling frequency deviation (dflt: 0.01) -a enable automatic conversion to audio device capabilities -ad enable automatic upsampling to 32/44.1/48 kHz if required (for digital audio device) -al lower limit for output sampling frequency [Hz] (dflt: none) -au upper limit for output sampling frequency [Hz] (dflt: none) -x enable channel & sample rate conversion -xf resampling for sub-sample start time accuracy -g amplitude gain (dflt: 1.0) -g0 add. ampl. gain for chan. 0 (left) (dflt: 1.0) -hp output high-pass filter frequency [Hz] (0=off) (dflt: 0.0) -ho output high-pass filter order (dflt: 1) -ts start time in input [sec] (use -xf for sub-sample accuracy) (dflt: 0.0) -td max. duration of output [sec] (without added silence) (0=unlimited) (dflt: 0.0) -tf force output duration [sec] (without added silence) (dflt: see -td) -ss strip leading and trailing silence -sq trailing silence to quit [sec] (0=off) (dflt: 0.0) -sm leading silence magnitude threshold [LSB] (trailing silence magnitude threshold = 0) (dflt: 0) -sl add leading silence [sec] (dflt: 0.0) -st add trailing silence [sec] (dflt: 0.0) -fi signal fade-in [sec] (dflt: 0.0) -fo signal fade-out [sec] (dflt: 0.0) -n no audio output (just show audio file format) -wd wplax: print time of played frames on stdout -wl wplax: list audio file format on stdout (no audio output) -b buffer size [sec] (if no sample rate conv.) (dflt: 0.2) -bf fragment size [sec] (recommended if only 2 fragments) -bp play buffer size [sec] (limit playback latency) (0 disables buffer control to prevent hangup) (dflt: 0.2) -ht sample rate conv.: num taps (-1 = auto) (dflt: -1) -al sample rate conv.: alpha for Kaiser window (-1 = auto) (dflt: -1.0) -fc sample rate conv.: 6 dB cutoff freq / input bandwidth (-1 = auto) (dflt: -1.0) -fd sample rate conv.: 100 dB cutoff freq / input bandwidth (-1 = auto) (dflt: -1.0) -d debug level (on stderr) (0=off 1=basic 2=med 3=high) (+4*austreamDbgLvl +16*playrecDbgLvl +64*rateconvDbgLvl) (dflt: 0) auquery -- query audio device capabilities ------------------------------------------ auquery: auquery V1.2 07-Jan-2003 autools-1.2.4 $Id: auquery.c,v 1.6 2003/01/19 23:17:09 purnhage Exp $ only 16 bit format supported usage: auquery -switches