AMBER v 1.1.2
Originally written by Jennifer Bernard <bernarjf@email.uc.edu> and Matthew McCabe <mccabem@bgnet.bgsu.edu> while they were students at the University of Richmond. Jenny has moved on to the University of Cincinatti College/Conservatory, and Matt has moved on to Bowling Green State University.
Matt currently lives in Sylvania, Ohio and is sporadically working on amber when time permits. Other contributors are more than welcome to work on the code, just drop me an email :)
INSTALLATION
Before you install, you should have checked to make sure you have libsndfile installed. This is common on Linux machines, but in order for amber to work on Mac OS X, you have to download and build it. As of this writing, libsndfile is not available via fink.
libsndfile home page is: http://www.zip.com.au/~erikd/libsndfile/
Once you're sure you have libsndfile installed and working, Go to the source tree for amber, and type 'make'.
This will generate the amber binary.
RUNNING AMBER
To run amber, you must have at least one .aiff file that you will be running
through the program. Two are included in with the download: lowsinefull.aiff
and multi.aiff. For command line parameters, type ./amber and you will
get a list of parameters. For example:
./amber -fn stereosine.aiff -fn multi.aiff -o out.aiff -fl 5.0 etc.
Please see the USAGE file for an explanation of the parameters!
You can also run a configuration file containing parameters through the program. A sample config file is included in parameters.txt. You can write your own config files by following the format of that file. Flags for the name of the parameter must be followed by a tab character, followed by the value of that parameter. Do not skip lines between parameters. ./amber -c parameters.txt will run amber using parameters contained in parameters.txt.
CAUTION! For the UNIX version, non-linear grain size and non-linear density have not been implemented. These options are in place for the graphical version of amber, which is off on the distant horizon somewhere. In the command line version, if you do not include a flag for linear grainsize/density, it will default to linear. However, if you type "no" in a config file, the program will probably segfault.
NOTES
The original program was developed under Red Hat 6.2, Kernel 2.2.16, using
vim and g++. Currently, most of the development is taking place on Mac OS
X, but we are trying to write it so that it's friendly for many platforms.
If you encounter problems, please drop me an email.
LICENSE
This program is released under the GNU public license. Please see
the file LICENSE for details on the terms of use and redistribution.
Please email bugs to one of the above email addresses, or post to our 'Bugs' forum on SourceForge. Tech support can also be obtained there, as well as the latest version.
DEVELOPEMENT
Amber is principally maintained by Matthew McCabe <mccabem@bgnet.bgsu.edu>.
If you'd like to help out with the development, or have ideas, please
email me!
Good luck, and thanks for trying out amber!