
              Plogue Rebuilder VST plugin version 1.04

               (c)2000-2003, Plogue Art et Technologie

                        http://www.plogue.com

--------------------------DISCLAIMER--------------------------------------
This plugin is musicware!
If you use this plugin in a commercial recording,
you HAVE to send us a copy of that recording!!
We're very curious to see the results you get. At least point us to a mp3 
file of something you did.
Also, needless to say, we're not responsible for destroyed speakers or ears,
(it can be really harsh sounding), loss of computer DATA, or hardware.                        
                       yada yada yada.
--------------------------------------------------------------------------

Revision History:

Version 1.04 
  Mach-o version for Mac OS X

Version 1.03
  First PowerMac port. Please report bugs if you find them.
  We optimized the code for that purpose a little bit,
  Hey, its now 2% faster...

Version 1.02
  Multiple Copies of Rebuilder can now run simultaneously!
  
Version 1.01
  Fixed Orion Buffer bug.
  Should work on most hosts without stuttering.

Version 1.0 
  Initial Release

Version 0.2beta
  AudioMulch Mailing list release.
  (only works in mulch)

-------------------------------------------------------------------------

But what does Rebuilder do?

This plugin analyses the frequency spectrum of
incoming data and rebuilds it - from scratch - by mixing a large matrix
of oscillators of any waveform type.
But it is mostly a DSP experiment that went berzerk.

Its parameters are:

WaveShapes:(sine, tri, saw, square, mixed) You get the idea.

Pitch:      Slightly detunes all present frequencies by a factor that
            you can't be bothered with.

Threshold:  What stays and what goes? 
            The louder the frequency, the more chance it has of surviving. 
            Since we don't normalize the parameter upon average input volume, 
            you might want to amplify the incoming sound to get everything out.

Processing: Percentage of regenerated frequencies starting with the lowest
            in the spectrum. (higher the %, the more CPU time it takes)
            Adding up to 512 oscillators in there.
            Watch this!!! Lower it down if you get overruns.

FFTSIZE:    Changes the quality of the sounds - and CPU load: 

 256) High temporal Precision, Low  frequency Precision, 128 osc, happy CPU. 
 512) Mid  temporal Precision, Mid  frequency Precision, 256 osc, irritated CPU.
1024) Low  temporal Precision, High frequency Precision, 512 osc, MAD CPU.
(And for the FFT litterate in you, no, it doesn't oversample)

KeepFreqs:  Keeping? Tries to reproduce the incoming frequency pitches.
            Not?     Ugly FFT bin frequencies are generated (vocoderish)
 _
/ \(on/off):Windowing function. Forces zero crossings at the edges of
            regenerated sample blocks.
			(it cuts the clicks but also parts of the life of the sound!)

HalfMoonMeter: There to bug you, it doesnt do anything....

-------------------------------------------------------------------------------
Bugs(features):

This does a very imprecise rebuilding of an audio signal.
Even using sine wave mode (Which could theoretically - from Fourier's laws - 
rebuild the signal)
Cause, for starts, it doesn't keep the relative phases of the frequencies in the 
spectrum, so that means all the waveforms have their starting points at the wrong
time.. (Ringing effect).
Low frequencies are most of the times clipped between buffers.
(but a high pass filter before Rebuilder if the clicks bugs you)
Or use the Windowing option.

Only the left input channel is used to capture data,
the output is sent to both channels though.
Rule of thumb: use mono signals.

This plugin was successfully tried in

Win32:
Bidule
AudioMulch
Steinberg WaveLab, Psycle, Cubase VST5 and Orion.

Mac OS (Classic):
Cubase 4.1 Demo.
on a PowerMac 4400/200, with 80 megs of ram.
(hard to be real time on this baby, but at least we have it!)

Mac OS X:
Bidule
  
This plugin could not have been made possible without the help
of these kind brains:

Bram de Jong of www.smartelectronix.com.
sMs at www.dspdimension.com,and 
m00 on the music-dsp mailing list.
Dubjay for inital mac port.
and
Eric Mattson for that handy CD.

Graphical design for plugin and web site were made by: 
Alexis Bellavance & Gregoire Gerardin

Send bugs/comments/suggestions to : support@plogue.com
-------------------------------------------------------------------------------
VST is a trademark of Steinberg Soft- und Hardware GmbH