Last updated: 6/1/06 - Jenny Bernard

This is a sample parameters file.  Cut below the dashes.
---------------------------------
# this is a comment line for this config file.
InputFile		multi.aiff
InputFile		stereosine.aiff
OutputFile		out2.aiff
OutputLength		10.0
InitialGrainSize	.02
FinalGrainSize		.02
LinearGrainSize		yes
InitialDensity		50
FinalDensity		50
LinearDensity		yes
WindowSize		15
Morphing		no
Envelope		1
GrainGenType		4
---------------------------------

Notice the file is tab delimited.  You can separate the parameter name
from its value with any number of tabs, but right now please use ONLY tab
characters.  Whitespace is considered part of the file. 



Possible parameters in an input file are listed below.  They can go in any
order you like: 

InputFile
	The name of the input file(s) (e.g. multi.aiff)
	This can be listed multiple times for an arbitrary number of input
        files.
	There is no real maximum -- just don't exceed your RAM :)

OutputFile 
	The name of the file to write

OutputLength 
	Length of the output file in seconds

InitialGrainSize 
	Initial grain size in seconds (range: .0003 and up, anything
        larger than 0.5 or so is not really granular synthesis anymore)

FinalGrainSize 
	Final grain size in seconds (range: .0003 and up)

LinearGrainSize 
	Is the evolution of grain size linear? right now, it must be yes.
	For future development, inputting of a set of numbers on a curve
	could be added to have non-linear grain size evolution.

InitialDensity 
	Initial grain density in grains per second 
	(actual range: 1 - 44099 -- at higher sampling rates you can
         theoretically have higher densities, but the math gets VERY
         weird and the results would be somewhat tragic.)

FinalDensity 
	Final grain density in grains per second (range same as above)

LinearDensity 
	Is the evolution of grain size linear? right now, it must be yes.
	For future development, inputting of a set of numbers on a curve
	could be added to have non-linear density evolution.

WindowSize 
	The range (in a percentage of the input file(s)) from which 
	groups of samples can be pulled at random.  Range is 1-100.
	Note:  this is a _percentage_.  don't put 234, or something like 
        that :)  The window progresses along the input data and chooses
	grains from within the window.

Morphing 
	Should the amplitude envelope change throughout the course of the
        output file?

Envelope
	If "Morphing" is no, this parameter is the number of the amplitude
        envelope (see below).

MorphStartEnvelope 
	If "Morphing" is yes, this parameter is the number of the initial
        envelope (see below).

MorphEndEnvelope
	If "Morphing" is yes, this parameter is the number of the final
        envelope.

        AMPLITUDE ENVELOPES
        -------------------
        1  Gaussian (bell curve)

        2  Triangle-shaped

        3  Square-shaped

        4  Plateau (parabolic increase and decrease, and flat in the middle)

        5  Simple Attack (sharp attack and slow release)

        6  Sine Curve

        7  Reverse Attack (slow attack and sharp release)

        8  Hexagon-shaped

        9  M-shaped
        -------------------



GrainGenType
	Number corresponding to the type of grain generation (see below).

        GRAIN GENERATOR TYPES
        -------------------
        1  Standard (one input file)

        2  Alternating (two or more files; grains are taken by pulling 
           grains from alternating files)

        3  Mixing (two or more files; all input files are mixed together and 
           grains are taken from the mix)

        4  Convolution (two files; input file 1 is convoluted with input 
           file 2)

        5  Fading (two files; one input file fades into the other, and 
           grains are taken from this mix)
        -------------------




There are several examples in the 'examples' directory included with 
the distribution.  There is also a perl script in the 'perl' directory
which gives a rough idea of how amber might be run from a script.
