Sampler
------------

Created by Mark Van Peteghem

This instrument plays audio files, and allows you to alter them. It plays both mono and stereo files (no need to specify this)
and takes the sample rate of the sample in account.

There are three play modes: play once, loop, and cycle. The first two should be obvious, the third means that the sample
will be used as the cycle that is repeated at audio rate, at the frequency given in p5 (pitch or frequency).

The first row of UI controls has the basic stuff: distortion of the table (done once to optimize, so not automatable), reversing,
selecting begin and end point to be played, begin and end speed up, stutter, optional attack and release, panning and volume adjustment.
Stutter length relates to the position in the original sample, so the actual stutter length may be shorter or longer due to the speedup settings.

The second row of UI controls has the more advanced stuff:
- Tune adjusts the pitch of the sample, either with pvscale or with delays (based on code by Victor Lazzarini).
If the pvscale method is used, the preservation of formants can be selected.
The amount of pitch adjustment can be selected with the knob in octaves (when 'Octaves' is selected) or
by specifying the wanted fequency in p5, if the pitch of the original sample is given in the text box (when 'Pitch in p5' is selected).
Note that the perceived pitch is also affected by the speedup knobs.
- Shift lets you use pvshift on the sample.
- Blur lets you use pvsblur on the sample.
- Smooth lets you use pvsmooth on the sample.
- Downsample lets you lower the sample frequency.
- Auto delay is an experimental feature that uses the sample itself to add a delay. This works best with samples
that only have low frequencies, like kick drums.
- Chorus adds a chorus, optionally distributing the different voices to the left and right channel.
- The filter settings should be obvious.

If the play mode is cycle, the speedup, stutter and tune settings are ignored.

Some knobs have a text field under them. These can be used to alter the value of the knob, e.g. entering +p6
when the value of the knob is 1, the used value will be 1+p6.