	

	           *auch*
	OH - ON4CKO      - aug 2006
	===========================


The *auch* program displays harmonics in music in various ways.

This distribution comes in two packages:
-1- a win32 setup (no sources) ; just run the installer.
-2- a linux/src package. We'll discuss this setup below, there are three sections: to compile, to run and to debug.
-3- macosx - is very experimental. I uses the linux/src package

To compile the program:
======================


AUCH needs 5 major libraries to build.  portaudio and libresample is not standard on most platforms.

- pthread 
	(see website for windows download ; default install on linux)
- portaudio (v18_1 / v19) 
	(see portaudio.com [freeware])
	the PA_COMPAT19 directive switches to the portaudio v19 API
- readline / termcap 
	(see website for windows download ; default installed on linux)
- fftw3 
	(fastest fourier of the west ; www.fftw.org )
- libresample 
	(see http://ccrma-www.stanford.edu/~jos/resample/Free_Resampling_Software.html)

It is designed to build both on LINUX and WINDOWS with the same sources.

On Linux:
	$ make <-- this builds the debug version
	$ ./auch
	audio--checker$ help
	... //some help
	audio--checker$ set
        ... //the default settings read from the file '.auchrc' 
	audio-checker$ plot test.wav
	... // watch the spectacle

	Note: -DLINUX is specified in the Makefile

On Mac OS X
	$ make -f Makefile.mac

        This makefile refers to the Cocaoaoao-thingy for the OpenGl.  It also
        refers to ./lib/libresample/libresample_mac.a for the mac os specific
        version of this library

	Note: The -DMACOSX define in Makefile.mac enables the correct directives

On windows:
	The code is tested on Visual Studio v6 and VS .NET (2003)
	The VS project (.dsp/.dsw) is not 'ready-to-go' since you have to change the include-path and library-paths of various libraries.  
	  The VC6 project  is no long up-to-date since version v1.6	  
	The  VS2003 project (.sln) should work fine, since the v1.7 release

	Note: -DWIN32 is specified in the project-workspace


To run the  pre-build linux program:
===================================

	$ cd prebuild
	... $ ./auch.linux  <-- try the pre-compiled program (your own risk)
        ... //same as above


To debug (on linux)
===================

        $ make  <-- build the debug version
        $ gdb auch
        $ handle SIG32 nostop pass print  <-- otherwise problems with stripped libraries.
	$ run


---- good luck!
---- 73, ON4CKO

More information:   hjeleas AT hotmail .dot. com

