Granulator.h

Go to the documentation of this file.

//
//  Granulator.h -- CSL class for doing granular synthesis
//  See the copyright notice and acknowledgment of authors in the file COPYRIGHT
//

#ifndef CSL_GRAN_H
#define CSL_GRAN_H

#include "CSL_Core.h"       // my superclass

namespace csl {                 // my namespace

#define MAX_GRAINS 200

// This implementation of grain assumes a linked list data structure
struct Grain {
    float amplitude;
    float frequency;
    long duration;
    float pan;
    long position;      //to maintain state of te sample position we are at in case it is played over the boundary of buffers
    Grain *nextGrain;       //A pointer to the next grain in the linked list
};

class Granulator : public UnitGenerator {

public:

    Granulator();
    virtual ~Granulator();

    Granulator(FrameStream &wave, FrameStream &env, FrameStream &rate, FrameStream &amp, FrameStream &freq, FrameStream &dur, FrameStream &pan);

    status nextBuffer(Buffer &inputBuffer, Buffer &outputBuffer);

    //status mono_next_buffer(Buffer & inputBuffer, Buffer & outputBuffer, unsigned inBufNum, unsigned outBufNum);

    int numGrains;

protected:

    UnitGenerator *mWave,       //the waveform that is played back granularized - current version does not implement
        *mEnv,              //generic envelope for all grains - current version does not implement
        *mRate,             //next_sample called when at the beginning of next_buffer - the rate of grains/second (this could be called more often)
        *mAmplitude,        //next_sample called when spawning a new grain to set amplitude multiplier
        *mFrequency,        //next_sample called when spawning a new grain to set frequency of wave (Hz) (in future: wave multiplier?)
        *mDuration,         //next_sample called when spawning a new grain to set duration (secs)
        *mPan;              //The pan position (-1 is left +1 is right)

    // Note: all calls that are used to set parameters for spawning grains are not realtime framestreams.
    // They will be modulated by the grain spawn rate; this could be fixed by calling next_sample a total 
    // of bufferLength times each next_buffer call.
    // Also, this would break down if there were more than 1 grain per sampletime being spawned (e.g. 44100grains/sec)
    Buffer rateBuff, durBuff, ampBuff, panBuff, freqBuff;

    //std::vector <Grain> *mGrains;     //an array of grains
    Grain * newGrain;
    Grain *deadGrains, *aliveGrains;

    bool outOfMemory;

};      // end of class spec.

}       // end of namespace

#endif

---