
AUDIO PLAYER
------------

Plays an audio recording in standard ED BLOB sample format.

Start and End offsets can be specified. Start must be >= 0. End can either be positive (specifying an offset from start, exactly as Start offset) or negative, for an offset relative to the sample end, where -1 corresponds to the last sample (default). The resulting End offset must always be > Start.

Nothing will be played when no valid sample data is present or Start / End offsets are inconsistent.

Gate enables playing, which can be interrupted and resumed (unless Auto Reset is enabled).

Playing continues up to the physical sample end, unless Loop is enabled, in which case the sample will be looped forever.

If Auto Reset is enabled, the playing position is reset to the Start offset every time Gate is triggered.

The original rate of the received sample, if known, should be specified with the Orig Rate Hz pin. Any value <= 0 (default) won't cause any rate conversion. NOTE: in case the original rate specified is larger than the current sample rate, no anti-aliasing is performed. If such a thing is really required, it is advised to perform it externally with the Resample DSP or GUI module, depending on your design.

A frequency scaling factor can be specified with the audio Freq Scal pin, suitable for pitch modulations, in linear units, where 1 (default) means no scaling, 2 means one octave up, 0.5 one octave down.
Negative values can be specified aswell to play the sample backwards.

Every time the Reset pin is set, the current playing position is resetted either to the Start offset or to the End offset, in case a negative frequency scaler is specified.

For convenience, the current playing position in samples is constantly output by the Position integer pin. Note that this pin, to prevent unnecessary control data flooding, is updated only once for every audio block (96 or 128 samples long, depending). This pin is mostly intended to provide visual feedback of the playing position, for example when connected to a Sample Marker.






