#############   fello 1.0 Documentation   ################

Until profound documentation for this software is available (and probably even after that), contact me for any help: pdguy@computer-musik.de
For Pd or Max users, it should not be hard to get this patch to work for their setup. Anybody else: ask me for a tutorial!
This document is intended to give information on where important parameters are to be found. In future releases, there will be a dedicated setup-subpatch for this.

## Quickstart Experienced Pd and Max users should need only the following information to get started:

# For your input settings, check subpatches fiddlein.pd, inlevel.pd, and noisegate.pd
# Set up your MIDI floorboard or footswitches in subpatches fiddlein.pd, delaylines.pd, and sample1.pd
# Choose your outputs in subpatches ambisonics_out.pd or stereo_out.pd and call one of them from the main window, depending on which output you want to have.


## Cross-Platform Compatibility

This patch was programmed under Windows and Mac OS X. It should run without any problem on both systems. Provided that you already have Pd installed on your machine, simply unpack the project folder into the Pd program folder and run the patch "fello_1_0.pd". Linux is also supported, however extensive testing has yet to be done.

non-standard-release externals required:
fiddle~
speedlim
ambipan~

Already included in the download are speedlim for Windows and ambipan~ for Windows, Mac OS X and Linux. Speedlim should be included in extended releases of Pd on Mac OS X and is available in maxlib on Linux. Fiddle~ should be in every Pd-extended release. 


## MIDI Implementation

Although most control information for the sound generation is derived from the live input, certain parameters are MIDI-controllable. The patch has been designed to work with a standard MIDI-floorboard sending program changes.

# Subpatch control.pd:

MIDI-channel 1, CC 41: MIDI follow
MIDI-channel 1, CC 42: spectral shift
(sliders in field "SpectralOperations")

# Subpatch miditempo.pd:

MIDI-channel 2, any note number: tempo sync, try continous quarter-notes

# Subpatch delaylines.pd:

MIDI-channel 16, prg change: prg #8 sets delay times to 0, #9 releases

# Subpatch sample1.pd:

MIDI-channel 16, prg change: prg #7 samples audio input to array sample1

# Subpatch fiddlein.pd:

MIDI-channel 16, prg change: prg #5 freezes audio input, #6 releases

# Subpatch midispectrum.pd:

MIDI-channel 1, note number: spectral frequencies of the resynthesis engine can build a spectrum on the MIDI-note received. The "follow MIDI" slider determines which partials follow the MIDI-note (starting with the lowest).


## Output/Speaker Setup

The setup this software was programmed with is 4-channel quadrophonic. Ambisonic technique is used to improve spatial impression for the audience. The ambipan~-external can be set to more speakers, using the same panning information already provided. Simply change the first argument in every ambipan~ object and connect the spare outputs to the dac~-object you also changed to the right number of speakers.

If you only want to use stereo outputs, there is a separate subpatch: stereo_out.pd
To use it, change the "ambisonics_out" call to "stereo_out" by typing into the same object in the main window.