Fractal Additive Synthesis Tools for Pure Data 0.35
===================================================
version 1.0

// This File is part of the
// Fractal Additive Synthesis Tools for Pure Data

// Copyright (C) 2002, Fritz Menzer
// Ecole Polytechnique Fédérale de Lausanne
// (EPFL)

// Fractal Additive Synthesis Technology:
// Copyright (C) Pietro Polotti and Gianpaolo Evangelista
// Laboratoire de Communications Audiovisuelles
// (LCAV)
// École Polytechnique Fédérale de Lausanne
// DSC-INR, Ecublens
// CH-1015, Lausanne, Switzerland
// [pietro.polotti,gianpaolo.evangeli sta]@epfl.ch

// You are free to use this code for any non-commercial purpose,
// provided that the above copyright notices are included in any
// software, hardware or publication derived from this code.


** General **

This distribution of the Fractal Additive Synthesis Tools
(FASTools) works with pd 0.35 under x86 Linux and Microsoft Windows.
It contains all the source files to compile it on your own. For
Windows there is a MS VC++ project (fastools/src/fastools.dsw)
and for Linux there are instruction on how to compile below.

For documentation on Fractal Additive Synthesis itself, please
refer to the articles published by Gianpaolo Evangelista and
Pietro Polotti, for example
http://lcavwww.epfl.ch/~pietro/fractal_synthesis.pdf,
an article in the Computer Music Journal Volume 25, No. 3
(Fall 2001) Issue or, if you want to have more precise information
on the inharmonic version which is implemented here:
http://www.unibw-hamburg.de/EWEB/ANT/dafx2002/papers/DAFX02_Polotti_Menzer_Evangelista_inharmonic_sound.pdf


** How to use the library **

To start PD with the fastools library, call in the fastools
directory (the one that contains fastools.pd_linux and
fastools.dll):
pd -lib fastools


** Wavelet transform filter length **

You can chose between two filter lengths: 4 taps and 12 taps.
Just copy all the files in the fastools/4tapWT or fastools/12tapWT
directory into the fastools directory. The default is 4 taps.


** LINUX **

To compile the library yourself, type in the source directory:
gcc -shared -o ../fastools.pd_linux *.c

To compile a single module:
gcc -shared -o module.pd_linux <libraries> module.c

<libraries> could be for example pd_ringbuffer.c

** WINDOWS **

To compile the library on the Windows platform, use the
MS VC++ project file (fastools/src/fastools.dsw). It will
generate the DLL file directly in the home directory (fastools).


Have fun!

Fritz Menzer
(fritz.menzer@epfl.ch)