#include <Nsound/Granulator.h>

Public Types
enum	EnvelopeType_e { CUSTOM, GAUSSIAN, GAUSSIAN_90, GAUSSIAN_70, GAUSSIAN_50, GAUSSIAN_30, GAUSSIAN_10, DECAY, REVERSE_DECAY }

Public Member Functions
	Granulator (const float64 &sample_rate, EnvelopeType_e env_type, const float64 &envelope_noise=0.0, const Buffer *custom_envelope=NULL)
	Creates a generator with the specified sample rate. More...

	Granulator (const Nsound::Granulator &gran)

virtual	~Granulator ()

Nsound::Buffer	generate (const float64 &duration, const float64 &grain_frequency, const float64 &waves_per_grain, const float64 &grains_per_second)

Nsound::Buffer	generate (const float64 &duration, const Nsound::Buffer &grain_frequency, const Nsound::Buffer &waves_per_grain, const Nsound::Buffer &grains_per_second) const

Nsound::Granulator &	operator= (const Nsound::Granulator &rhs)
	Assignment operator. More...

Protected Member Functions
	Granulator ()

Protected Attributes
float64	sample_rate_

Generator *	envelope_generator_

Detailed Description

Definition at line 51 of file Granulator.h.

Member Enumeration Documentation

enum Nsound::Granulator::EnvelopeType_e

Enumerator
CUSTOM
GAUSSIAN
GAUSSIAN_90
GAUSSIAN_70
GAUSSIAN_50
GAUSSIAN_30
GAUSSIAN_10
DECAY
REVERSE_DECAY

Definition at line 55 of file Granulator.h.

     {
         CUSTOM,
         GAUSSIAN,
         GAUSSIAN_90,
         GAUSSIAN_70,
         GAUSSIAN_50,
         GAUSSIAN_30,
         GAUSSIAN_10,
         DECAY,
         REVERSE_DECAY
     };

Constructor & Destructor Documentation

Granulator::Granulator	(	const float64 &	sample_rate,
		EnvelopeType_e	env_type,
		const float64 &	envelope_noise = `0.0`,
		const Buffer *	custom_envelope = `NULL`
	)

Creates a generator with the specified sample rate.

Definition at line 49 of file Granulator.cc.

References CUSTOM, DECAY, Nsound::Generator::drawDecay(), Nsound::Generator::drawFatGaussian(), Nsound::Generator::drawGaussian(), envelope_generator_, GAUSSIAN, GAUSSIAN_10, GAUSSIAN_30, GAUSSIAN_50, GAUSSIAN_70, GAUSSIAN_90, Nsound::Buffer::getLength(), Nsound::Buffer::getReverse(), M_THROW, REVERSE_DECAY, sample_rate_, and Nsound::Generator::whiteNoise().

     :
     sample_rate_(sample_rate),
     envelope_generator_(NULL)
 //     sine_(new Sine(sample_rate_)),
 //     current_time_(0.0),
 //     next_grain_time_(0.0),
 //     last_grain_time_(0.0),
 //     time_step_(1.0 / sample_rate_)
 {
     Generator gen(sample_rate_);
 
     switch(env_type)
     {
         case Granulator::CUSTOM:
         {
             if(custom_envelope == NULL
                 || custom_envelope->getLength() != sample_rate_)
             {
                 M_THROW("custom_envelope->getLength() must equal "
                      << sample_rate_
                      << ", length is "
                      << custom_envelope->getLength());
 
                 envelope_generator_ =
                     new Generator(
                         sample_rate_,
                         gen.drawGaussian(1.0, 0.5, 0.33333)
                           * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             }
             else
             {
                 envelope_generator_ =
                     new Generator(
                         sample_rate_,
                         (*custom_envelope)
                             * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             }
             break;
         }
 
         case Granulator::GAUSSIAN:
         {
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawGaussian(1.0, 0.5, 0.33333)
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
 
         case Granulator::GAUSSIAN_90:
         {
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawFatGaussian(1.0, 0.90)
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
 
         case Granulator::GAUSSIAN_70:
         {
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawFatGaussian(1.0, 0.70)
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
 
         case Granulator::GAUSSIAN_50:
         {
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawFatGaussian(1.0, 0.50)
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
 
         case Granulator::GAUSSIAN_30:
         {
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawFatGaussian(1.0, 0.30)
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
 
         case Granulator::GAUSSIAN_10:
         {
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawFatGaussian(1.0, 0.10)
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
 
         case Granulator::DECAY:
         {
             Buffer waveform(static_cast<uint32>(sample_rate_));
 
             waveform << gen.drawDecay(1.0);
 
             Buffer noise = 1.0 + envelope_noise * gen.whiteNoise(1.0);
 
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawDecay(1.0)
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
 
         case Granulator::REVERSE_DECAY:
         {
             envelope_generator_ = new Generator(
                 sample_rate_,
                 gen.drawDecay(1.0).getReverse()
                     * (1.0 + envelope_noise * gen.whiteNoise(1.0)));
             break;
         }
     }
 }

Granulator::Granulator ( const Nsound::Granulator & gran )

Definition at line 176 of file Granulator.cc.

     :
     sample_rate_(gran.sample_rate_),
     envelope_generator_(NULL)
 {
     *this = gran;
 }

Granulator::~Granulator ( )

virtual

Definition at line 186 of file Granulator.cc.

References envelope_generator_.

 {
     delete envelope_generator_;
 }

Nsound::Granulator::Granulator ( )

protected

Member Function Documentation

Buffer Granulator::generate	(	const float64 &	duration,
		const float64 &	grain_frequency,
		const float64 &	waves_per_grain,
		const float64 &	grains_per_second
	)

Definition at line 193 of file Granulator.cc.

References Nsound::Buffer::add(), envelope_generator_, Nsound::Generator::generate(), and sample_rate_.

Referenced by main(), and my_main().

 {
     Sine sin(sample_rate_);
 
     float64 time_step = 1.0 / sample_rate_;
 
     Buffer y(4096);
 
     for(float64 last_g_time = 0.0, current_time = 0.0, next_grain_time = 0.0;
         current_time < duration;
         current_time += time_step)
     {
         // Output a pulse.
         if(next_grain_time - current_time < time_step)
         {
             float64 g_duration  = waves_per_grain / grain_frequency;
 
             Buffer grain(4096);
 
             grain <<  sin.generate(g_duration, grain_frequency)
                     * envelope_generator_->generate(g_duration, 1.0 / g_duration);
 
             y.add(grain, static_cast<uint32>(current_time * sample_rate_));
 
             last_g_time = current_time;
         }
 
         next_grain_time = last_g_time + (1.0 / grains_per_second);
     }
 
     return y;
 }

Buffer Granulator::generate	(	const float64 &	duration,
		const Nsound::Buffer &	grain_frequency,
		const Nsound::Buffer &	waves_per_grain,
		const Nsound::Buffer &	grains_per_second
	)		const

Definition at line 232 of file Granulator.cc.

References Nsound::Buffer::add(), envelope_generator_, Nsound::Generator::generate(), Nsound::Buffer::getLength(), and sample_rate_.

 {
     Sine sin(sample_rate_);
 
     uint32 gf_length  = grain_frequency.getLength();
     uint32 wpg_length = waves_per_grain.getLength();
     uint32 gps_length = grains_per_second.getLength();
 
     uint32 gf_index = 0;
     uint32 wpg_index = 0;
     uint32 gps_index = 0;
 
     float64 time_step = 1.0 / sample_rate_;
 
     Buffer y;
 
     for(float64 last_g_time = 0.0, current_time = 0.0, next_grain_time = 0.0;
         current_time < duration;
         current_time += time_step)
     {
 
         float64 gps =
             grains_per_second[gps_index++ % gps_length];
 
         // Output a pulse.
         if(next_grain_time - current_time < time_step)
         {
             float64 g_frequency = grain_frequency[gf_index++  % gf_length];
             float64 wpg         = waves_per_grain[wpg_index++ % wpg_length];
 
             float64 g_duration  = wpg / g_frequency;
 
             Buffer grain =
                 sin.generate(g_duration,g_frequency)
                 * envelope_generator_->generate(g_duration, 1.0 / g_duration);
 
             y.add(grain, static_cast<uint32>(current_time * sample_rate_));
 
             last_g_time = current_time;
         }
 
         next_grain_time = last_g_time + (1.0 / gps);
     }
 
     return y;
 }

Granulator & Granulator::operator= ( const Nsound::Granulator & rhs )

Assignment operator.

Definition at line 287 of file Granulator.cc.

References envelope_generator_, and sample_rate_.

 {
     delete envelope_generator_;
 
     sample_rate_ = rhs.sample_rate_;
     envelope_generator_ = new Generator(*rhs.envelope_generator_);
 
     return *this;
 }