]> CRI, Mines Paris - PSL - Faustine.git/blobdiff - interpreter/preprocessor/faust-0.9.47mr3/README
Rename interpretor to interpreter.
[Faustine.git] / interpreter / preprocessor / faust-0.9.47mr3 / README
diff --git a/interpreter/preprocessor/faust-0.9.47mr3/README b/interpreter/preprocessor/faust-0.9.47mr3/README
new file mode 100644 (file)
index 0000000..2b90efc
--- /dev/null
@@ -0,0 +1,151 @@
+                       FAUST : a programming language for
+                         audio applications and plugins
+                                       ==============
+        Grame, Centre National de Creation Musicale
+                                http://www.grame.fr
+
+
+
+1/ Introduction
+----------------
+FAUST (Functional Audio Stream) is a functional programming
+language specifically designed for real-time signal processing and
+synthesis. A distinctive characteristic of FAUST is to be fully
+compiled. 
+
+The FAUST compiler translates DSP specifications into
+very efficient C++ code that works at sample level. It targets
+high-performance signal processing applications, libraries and
+audio plug-ins for a variety of audio platforms and standards. A
+same FAUST specification can be used to easily generate native
+JACK or ALSA applications, as well as CSOUND, LADSPA, MAX/MSP, PD,
+Q, SC and VST plugins. 
+
+
+2/ Organisation of the distribution
+-----------------------------------
+The Faust distribution can be downloaded at:
+       http://sourceforge.net/projects/faudiostream
+
+It's organisation is the following :
+
+       architecture/           : the architecture files and libraries 
+                                                 currently supported
+       benchmark/                      : tools to measure the impact of various 
+                          compiler options
+       compiler/                       : sources of the Faust compiler
+       documentation /         : Faust developer's documentation
+       examples/                       : examples of Faust programs with makefiles
+                                                 for various audio targets
+       syntax-highlighting/: support for syntax highlighting for 
+                                                 several editors
+       tools/                          : Additional easy-to-use scripts to 
+                                                 produce binaries and plugins
+
+
+3/ Compilation and installation
+--------------------------------
+To compile and install the Faust compiler on Linux and MacOSX : 
+
+       make
+       su
+       make install
+or
+       sudo make install
+
+It could be also useful to install additional tools, for example :
+
+       cd tools/faust2appls/
+       sudo make install
+
+On Windows :
+
+The first option is to use the Visual Studio 2008 solution
+/faust/compiler/windows/faust_vs2008.sln. Open the solution with
+the Visual Studio 2008 environment and run Build. Both
+Debug/Release targets are supported.
+
+The second solution is to download and install the QT4.6 SDK : 
+       http://qt.nokia.com/downloads/sdk-windows-cpp
+and use the project file 'compiler.pro' in the compiler folder.
+
+
+2/ Compilation of the examples
+-------------------------------
+Several FAUST examples are provided in the example folder. To
+compile and test the examples with Jack/GTK do :
+
+       cd examples
+       make jackgtk
+
+This will create a subfolder jackgtkdir with all the jack
+applications. You can also create alsa applications (make alsagtk)
+as well as other formats.
+
+In order to compile your own applications, you can simply place you
+files in the example folder and use the existing makefiles.
+
+To list for possible audio targets :
+
+       make help
+
+About 20 different audio plateforms are supported : 
+
+- Action Script
+- Alsa
+- ChucK
+- CoreAudio
+- CSOUND
+- iPhone
+- Jack
+- LADSPA
+- Matlab
+- MaxMSP
+- Octave
+- OSS
+- PortAudio
+- Pure
+- PureData
+- Q
+- Sndfile
+- Snd-RT
+- SuperCollider
+- SynthFile
+- VST
+- VSTi (mono)
+
+For all these audio platforms you may have to install the related
+SDK and/or development libraries.
+
+4/ Acknowledgments
+------------------
+
+Many persons have been contributing to the FAUST project by
+providing code for the compiler, architecture files, libraries,
+examples, documentation, scripts, bug reports, ideas, etc. 
+
+I would like to thank them and especially: Fons Adriaensen, Tiziano
+Bole, Baktery Chanka, Thomas Charbonnel, Damien Cramet, Etienne
+Gaudrin, Albert Graef, Stefan Kersten, Victor Lazzarini, Matthieu
+Leberre, Mathieu Leroi, Kjetil Matheussen, Remy Muller, Sampo
+Savolainen, Nicolas Scaringella, Stephen Sinclair, Travis Skare,
+Julius Smith, as well as my colleagues at GRAME, in particular :
+Dominique Fober, Stephane Letz and Karim Barkati, and from the
+ASTREE project : Jerome Barthelemy (IRCAM), Alain Bonardi (IRCAM),
+Raffaele Ciavarella (IRCAM), Pierre Jouvelot (Ecole des
+Mines/ParisTech), Laurent Pottier (U. Saint-Etienne)
+
+
+5/ Questions and suggestions
+----------------------------
+
+If you have questions suggestions and comments, or if you want to 
+contribute to the project, two mailing lists are available:
+https://lists.sourceforge.net/lists/listinfo/faudiostream-devel
+https://lists.sourceforge.net/lists/listinfo/faudiostream-users
+
+
+
+
+Yann Orlarey
+