SpeakerLayout.h

Go to the documentation of this file.

/*
 *  Created by Jorge Castellanos on 6/16/06.
 *  Copyright 2006 Jorge Castellanos. All rights reserved.
 */


#ifndef SPEAKERLAYOUT_H
#define SPEAKERLAYOUT_H

#include "CSL_Core.h"
#include "CPoint.h"

namespace csl {

class Speaker; // Forward declaration. See below.

class SpeakerLayout : public Model {
public:
    // Constructors & destructor:
    SpeakerLayout(char *filePath = NULL);   
    ~SpeakerLayout();               

    static SpeakerLayout *defaultSpeakerLayout();
    static void setDefaultSpeakerLayout(SpeakerLayout *defalutLayout);
    
    void addSpeaker(float azimuth, float elevation = 0.0, float radius = 1.0);

    unsigned numSpeakers() const { return mSpeakers.size(); };  

    void normalizeSpeakerDistances(float radius = 0);
    
    Speaker *speakerAtIndex(unsigned speakerIndex) const { return mSpeakers[speakerIndex]; };

    bool isPeriphonic() { return (mDimensions == 3); }; 
    void dump();

private:
    vector<Speaker *> mSpeakers;        
    unsigned mDimensions;
//  void cartesianToSphericalRadians(); // convert speaker layout given in cartesian coordinates to spherical radians
    static SpeakerLayout *sDefaultSpeakerLayout;
    float *mSpeakerDistanceDeltas; 
    
public:
    SpeakerLayout &operator=(const SpeakerLayout &layout); 
};


class StereoSpeakerLayout : public SpeakerLayout {
public:
    StereoSpeakerLayout();

};


class Speaker {
public:
    Speaker(float azimuth = 0.0, float elevation = 0.0, float radius = 1.0) :  mPosition('s', radius, azimuth, elevation) {};
    ~Speaker() {};
    
    CPoint position()   { return mPosition; }; // Return the position of the speaker.
    float azimuth()     { return mPosition.theta(); };
    float elevation()   { return mPosition.ele(); };
    float radius()      { return mPosition.r(); };
    void setRadius(float radius); 
    
    void dump(); 

protected:
    CPoint mPosition;
    
}; 

//class RingBuffer;

//class ActiveSpeakerLayout : public Effect, public SpeakerLayout  {
//public:
//  ActiveSpeakerLayout(UnitGenerator &input, char *filePath = NULL) {}; ///< Optionally reads loudspeaker layout from file
//  ~ActiveSpeakerLayout() {};
//  
//  setSpeakerDistanceCompensation(bool shouldCompensate) { mCompensatesForDistance = shouldCompensate; };
//  setRemapsChannels(bool remapIOChannels) { mRemapsChannels = remapIOChannels; };
//
//  virtual void nextBuffer(Buffer & outputBuffer, unsigned outBufNum) throw (Exception);
//  
//private:
//  bool mCompensatesForDistance;
//  bool mRemapsChannels;
//  
//};

}

#endif

---