I quickly drew something in Paint
What you see here is:
- At frequencies below Start Freq, nothing happens
- At Start Freq, a full rotation occurs at a certain speed (should be related to the 'speed' parameter, but there's a bug in the calculation so setting it to 1500 Hz does not mean that the first rotation ends at start freq + 1500, but a lot sooner. I'll fix that later.)
- From that point on, the rotation speed goes DOWN very rapidly.
(Note that -180 degrees equals +180 degrees; there's no jump at the sides of the image)
This would give a very rough transition at the start freq (which in turn causes horrible pre-ringing etc.). To fix that, I've added a smoothing parameter that slowly follows the values that are drawn in this picture. So instead of a steep angle at the start, it starts very smoothly (which also means that very little happens near the start frequency). Setting smoothing higher means that the following is done more slowly, so the same phase rotation is reached at a higher frequency.
- Setting the start frequency higher means that lower frequencies (where a similar shift in phase means a much bigger difference in time) are left unaltered, so the sound will be more natural. But you risk getting more distortion.
- Setting the speed at a higher frequency means that rotation is SLOWER (!!!) - hence also that there's less difference compared to the original sound, but more chance of getting distortion.
- Setting smoothing higher also reduces the effect (especially at lower frequencies), so that also makes the sound more similar to the original, but you might risk getting more distortion. Setting it to lower values causes horrible amounts of pre-ringing (probably due to the steeper start).