Remove stub class.
[ardour.git] / libs / ardour / ardour / panner.h
index 86cd4861136b3c7d6aa8ec1a0c25463f9e5ac18c..2b2801841d812570bbb8441600ff4afd3dcd7dc9 100644 (file)
@@ -25,7 +25,6 @@
 #include <vector>
 #include <string>
 #include <iostream>
-#include <sigc++/signal.h>
 
 #include "pbd/stateful.h"
 #include "pbd/controllable.h"
@@ -41,7 +40,7 @@ class Panner;
 class BufferSet;
 class AudioBuffer;
 
-class StreamPanner : public sigc::trackable, public PBD::Stateful
+class StreamPanner : public PBD::Stateful
 {
   public:
        StreamPanner (Panner& p, Evoral::Parameter param);
@@ -54,24 +53,35 @@ class StreamPanner : public sigc::trackable, public PBD::Stateful
        void set_position (float x, float y, bool link_call = false);
        void set_position (float x, float y, float z, bool link_call = false);
 
-       void get_position (float& xpos) const { xpos = x; }
-       void get_position (float& xpos, float& ypos) const { xpos = x; ypos = y; }
-       void get_position (float& xpos, float& ypos, float& zpos) const { xpos = x; ypos = y; zpos = z; }
+       void get_position (float& xpos) const { xpos = _x; }
+       void get_position (float& xpos, float& ypos) const { xpos = _x; ypos = _y; }
+       void get_position (float& xpos, float& ypos, float& zpos) const { xpos = _x; ypos = _y; zpos = _z; }
 
        void get_effective_position (float& xpos) const { xpos = effective_x; }
        void get_effective_position (float& xpos, float& ypos) const { xpos = effective_x; ypos = effective_y; }
        void get_effective_position (float& xpos, float& ypos, float& zpos) const { xpos = effective_x; ypos = effective_y; zpos = effective_z; }
 
+       void distribute (AudioBuffer &, BufferSet &, gain_t, nframes_t);
+       void distribute_automated (AudioBuffer &, BufferSet &, nframes_t, nframes_t, nframes_t, pan_t **);
+
        /* the basic StreamPanner API */
 
-       virtual void distribute (AudioBuffer& src, BufferSet& obufs, gain_t gain_coeff, nframes_t nframes) = 0;
-       virtual void distribute_automated (AudioBuffer& src, BufferSet& obufs,
-                       nframes_t start, nframes_t end, nframes_t nframes, pan_t** buffers) = 0;
+       /**
+        *  Pan some input samples to a number of output buffers.
+        *
+        *  @param src Input buffer.
+        *  @param obufs Output buffers (one per panner output).
+        *  @param gain_coeff Gain coefficient to apply to output samples.
+        *  @param nframes Number of frames in the input.
+        */
+       virtual void do_distribute (AudioBuffer& src, BufferSet& obufs, gain_t gain_coeff, nframes_t nframes) = 0;
+       virtual void do_distribute_automated (AudioBuffer& src, BufferSet& obufs,
+                                             nframes_t start, nframes_t end, nframes_t nframes, pan_t** buffers) = 0;
 
        boost::shared_ptr<AutomationControl> pan_control()  { return _control; }
 
-       sigc::signal<void> Changed;      /* for position */
-       sigc::signal<void> StateChanged; /* for mute */
+       PBD::Signal0<void> Changed;      /* for position */
+       PBD::Signal0<void> StateChanged; /* for mute, mono */
 
        int set_state (const XMLNode&, int version);
        virtual XMLNode& state (bool full_state) = 0;
@@ -79,16 +89,17 @@ class StreamPanner : public sigc::trackable, public PBD::Stateful
        Panner & get_parent() { return parent; }
 
        /* old school automation loading */
-
        virtual int load (std::istream&, std::string path, uint32_t&) = 0;
 
   protected:
        friend class Panner;
        Panner& parent;
 
-       float x;
-       float y;
-       float z;
+       void set_mono (bool);
+       
+       float _x;
+       float _y;
+       float _z;
 
        /* these are for automation. they store the last value
           used by the most recent process() cycle.
@@ -99,10 +110,13 @@ class StreamPanner : public sigc::trackable, public PBD::Stateful
        float effective_z;
 
        bool _muted;
+       bool _mono;
 
        boost::shared_ptr<AutomationControl> _control;
 
        void add_state (XMLNode&);
+
+       /* Update internal parameters based on _x, _y and _z */
        virtual void update () = 0;
 };
 
@@ -113,12 +127,12 @@ class BaseStereoPanner : public StreamPanner
        ~BaseStereoPanner ();
 
        /* this class just leaves the pan law itself to be defined
-          by the update(), distribute_automated()
+          by the update(), do_distribute_automated()
           methods. derived classes also need a factory method
           and a type name. See EqualPowerStereoPanner as an example.
        */
 
-       void distribute (AudioBuffer& src, BufferSet& obufs, gain_t gain_coeff, nframes_t nframes);
+       void do_distribute (AudioBuffer& src, BufferSet& obufs, gain_t gain_coeff, nframes_t nframes);
 
        /* old school automation loading */
 
@@ -139,8 +153,8 @@ class EqualPowerStereoPanner : public BaseStereoPanner
        EqualPowerStereoPanner (Panner&, Evoral::Parameter param);
        ~EqualPowerStereoPanner ();
 
-       void distribute_automated (AudioBuffer& src, BufferSet& obufs,
-                       nframes_t start, nframes_t end, nframes_t nframes, pan_t** buffers);
+       void do_distribute_automated (AudioBuffer& src, BufferSet& obufs,
+                                     nframes_t start, nframes_t end, nframes_t nframes, pan_t** buffers);
 
        void get_current_coefficients (pan_t*) const;
        void get_desired_coefficients (pan_t*) const;
@@ -162,9 +176,9 @@ class Multi2dPanner : public StreamPanner
        Multi2dPanner (Panner& parent, Evoral::Parameter);
        ~Multi2dPanner ();
 
-       void distribute (AudioBuffer& src, BufferSet& obufs, gain_t gain_coeff, nframes_t nframes);
-       void distribute_automated (AudioBuffer& src, BufferSet& obufs,
-                       nframes_t start, nframes_t end, nframes_t nframes, pan_t** buffers);
+       void do_distribute (AudioBuffer& src, BufferSet& obufs, gain_t gain_coeff, nframes_t nframes);
+       void do_distribute_automated (AudioBuffer& src, BufferSet& obufs,
+                                     nframes_t start, nframes_t end, nframes_t nframes, pan_t** buffers);
 
        static StreamPanner* factory (Panner&, Evoral::Parameter);
        static std::string name;
@@ -182,7 +196,10 @@ class Multi2dPanner : public StreamPanner
 };
 
 
-class Panner : public SessionObject, public AutomatableControls
+/** Class to pan from some number of inputs to some number of outputs.
+ *  This class has a number of StreamPanners, one for each input.
+ */
+class Panner : public SessionObject, public Automatable
 {
 public:
        struct Output {
@@ -192,11 +209,10 @@ public:
                pan_t desired_pan;
 
                Output (float xp, float yp)
-                       : x (xp), y (yp), current_pan (0.0f), desired_pan (0.f) {}
+                       : x (xp), y (yp), current_pan (0), desired_pan (0) {}
 
        };
 
-       //Panner (std::string name, Session&, int _num_bufs);
        Panner (std::string name, Session&);
        virtual ~Panner ();
 
@@ -214,11 +230,10 @@ public:
        /// The fundamental Panner function
        void run (BufferSet& src, BufferSet& dest, sframes_t start_frame, sframes_t end_frames, nframes_t nframes);
 
-       //void* get_inline_gui() const = 0;
-       //void* get_full_gui() const = 0;
-
        bool bypassed() const { return _bypassed; }
        void set_bypassed (bool yn);
+       bool mono () const { return _mono; }
+       void set_mono (bool);
 
        StreamPanner* add ();
        void remove (uint32_t which);
@@ -238,8 +253,6 @@ public:
        uint32_t nouts() const { return outputs.size(); }
        Output& output (uint32_t n) { return outputs[n]; }
 
-       std::vector<Output> outputs;
-
        enum LinkDirection {
                SameDirection,
                OppositeDirection
@@ -254,9 +267,9 @@ public:
        StreamPanner &streampanner( uint32_t n ) const { assert( n < _streampanners.size() ); return *_streampanners[n]; }
        uint32_t npanners() const { return _streampanners.size(); }
 
-       sigc::signal<void> Changed;
-       sigc::signal<void> LinkStateChanged;
-       sigc::signal<void> StateChanged; /* for bypass */
+       PBD::Signal0<void> Changed; /* panner and/or outputs count changed */
+       PBD::Signal0<void> LinkStateChanged;
+       PBD::Signal0<void> StateChanged; /* for bypass */
 
        /* only StreamPanner should call these */
 
@@ -283,11 +296,11 @@ public:
        };
 
        boost::shared_ptr<AutomationControl> pan_control (int id, int chan=0) {
-               return automation_control(Evoral::Parameter (PanAutomation, chan, id));
+               return automation_control (Evoral::Parameter (PanAutomation, chan, id));
        }
 
        boost::shared_ptr<const AutomationControl> pan_control (int id, int chan=0) const {
-               return automation_control(Evoral::Parameter (PanAutomation, chan, id));
+               return automation_control (Evoral::Parameter (PanAutomation, chan, id));
        }
 
   private:
@@ -295,10 +308,12 @@ public:
        Panner (Panner const &);
 
        void distribute_no_automation(BufferSet& src, BufferSet& dest, nframes_t nframes, gain_t gain_coeff);
-       std::vector<StreamPanner*> _streampanners;
+       std::vector<StreamPanner*> _streampanners; ///< one StreamPanner per input
+       std::vector<Output> outputs;
        uint32_t     current_outs;
        bool             _linked;
        bool             _bypassed;
+       bool             _mono;
        LinkDirection    _link_direction;
 
        static float current_automation_version_number;