
RESAMPLE (DSP & GUI)
--------------------


DSP VERSION
-----------

Re-sample the input sample from a source rate (Rate In) to a destination rate (Rate Out) in Hz.

When the source rate is <=0 (or unset) or when it is the same as the destination rate, the input sample is forwarded to output unchanged. Please always specify a valid source rate, either by hand of from the WAV Loaders Sample Rate pin, since BLOB samples carry NO INFORMATION about the original sample rate.

You can specify a destination rate <=0 to use the current working sample rate (default).





GUI VERSION
-----------

To avoid unpredictable behaviours and side effects, direction of operation (forward, "->" or backwards "<-") must be set explicitely with the unexposed Direction pin.

Source Rate and Dest Rate always refer to the Sample pins which act as Source and Destination, respectively, depending on the Direction setting.

Everytime the Sample pin acting as source or a Rate pin are updated, re-sampling from a source to a destination rate is performed and the result is transmitted to the opposite Sample pin.

Specifying any Hz value <= 0 (i.e invalid) will cause transmission of the source sample unchanged.

Keep in mind that the GUI end has NO knowledge of the working sample rate, it shall be supplied thru conversion from the DSP end (either using ED GUI Sample Rate module or the stock Sample Rate plus a Patch Memory Float Out).




IMPORTANT NOTES
---------------

-YOU SHOULD NEVER USE GUI RESAMPLERS UNLESS IN VERY SPECIAL CASES AND UNDER YOUR TOTAL RESPONSIBILITY.
ALWAYS RESAMPLE ON THE FLY ON THE DSP SIDE IF POSSIBLE.

-YOU MUST NOT USE THESE MODULES WITH SAMPLING MODULES WHICH ALREADY PERFORM SOME KIND OF OVERSAMPLING INTERNALLY I.E WHICH HAVE AN "ORIGINAL RATE" PIN OR ALIKE (EG. OSCILLATORS)

-YOU ARE STRONGLY ADVISED NOT TO ABUSE THESE MODULES WITH VERY LONG SAMPLES ("RECORDINGS") SINCE DOING SO MAY CAUSE AUDIO DROP-OUTS (DSP VERSION) OR GUI "HICCUPS" (GUI VERSION)

-NEVER USE GUI RESAMPLERS FOR FUNCTIONAL CIRCUITS, SINCE THE GUI IS NOT OPERATIONAL WHEN THE PLUGIN PANEL IS CLOSED !




ABOUT THE ALGORITHM USED
-------------------------

At present, a very fast but effective spline method is used for both upsampling and downsampling, which represents a valid trade-off between accuracy and CPU cost. When down-sampling, some residual aliasing is still noticeable in the upper spectrum end as an effect of imperfect brickwall filtering, but it is pretty not audible.















