libs/ardour/ardour/delivery.h

   1 /*
   2     Copyright (C) 2006 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify it
   5     under the terms of the GNU General Public License as published by the Free
   6     Software Foundation; either version 2 of the License, or (at your option)
   7     any later version.
   8
   9     This program is distributed in the hope that it will be useful, but WITHOUT
  10     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11     FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12     for more details.
  13
  14     You should have received a copy of the GNU General Public License along
  15     with this program; if not, write to the Free Software Foundation, Inc.,
  16     675 Mass Ave, Cambridge, MA 02139, USA.
  17 */
  18
  19 #ifndef __ardour_delivery_h__
  20 #define __ardour_delivery_h__
  21
  22 #include <string>
  23 #include "ardour/types.h"
  24 #include "ardour/chan_count.h"
  25 #include "ardour/io_processor.h"
  26
  27 namespace ARDOUR {
  28
  29 class BufferSet;
  30 class IO;
  31 class MuteMaster;
  32 class Panner;
  33
  34 class Delivery : public IOProcessor {
  35 public:
  36         enum Role {
  37                 Insert = 0x1,
  38                 Send   = 0x2,
  39                 Listen = 0x4,
  40                 Main   = 0x8
  41         };
  42
  43         /* Delivery to an existing output */
  44
  45         Delivery (Session& s, boost::shared_ptr<IO> io, boost::shared_ptr<MuteMaster> mm, const std::string& name, Role);
  46         Delivery (Session& s, boost::shared_ptr<IO> io, boost::shared_ptr<MuteMaster> mm, const XMLNode&);
  47
  48         /* Delivery to a new output owned by this object */
  49
  50         Delivery (Session& s, boost::shared_ptr<MuteMaster> mm, const std::string& name, Role);
  51         Delivery (Session&, boost::shared_ptr<MuteMaster> mm, const XMLNode&);
  52
  53         bool set_name (const std::string& name);
  54         bool visible() const;
  55         Role role() const { return _role; }
  56         bool can_support_io_configuration (const ChanCount& in, ChanCount& out) const;
  57         bool configure_io (ChanCount in, ChanCount out);
  58
  59         void run (BufferSet& bufs, sframes_t start_frame, sframes_t end_frame, nframes_t nframes);
  60
  61         /* supplemental method use with MIDI */
  62
  63         void flush (nframes_t nframes);
  64
  65         void no_outs_cuz_we_no_monitor(bool);
  66
  67         void mod_solo_level (int32_t);
  68         uint32_t solo_level() const { return _solo_level; }
  69         bool soloed () const { return (bool) _solo_level; }
  70
  71         bool solo_isolated() const { return _solo_isolated; }
  72         void set_solo_isolated (bool);
  73
  74         void cycle_start (nframes_t);
  75         void increment_output_offset (nframes_t);
  76         void transport_stopped (sframes_t frame);
  77
  78         BufferSet& output_buffers() { return *_output_buffers; }
  79
  80         sigc::signal<void> MuteChange;
  81
  82         static sigc::signal<void,nframes_t> CycleStart;
  83
  84         XMLNode& state (bool full);
  85         int set_state (const XMLNode&);
  86
  87         /* Panning */
  88
  89         static int  disable_panners (void);
  90         static int  reset_panners (void);
  91
  92         boost::shared_ptr<Panner> panner() const { return _panner; }
  93
  94         void reset_panner ();
  95         void defer_pan_reset ();
  96         void allow_pan_reset ();
  97
  98         uint32_t pans_required() const { return _configured_input.n_audio(); }
  99         void start_pan_touch (uint32_t which);
 100         void end_pan_touch (uint32_t which);
 101
 102   protected:
 103         Role        _role;
 104         BufferSet*  _output_buffers;
 105         gain_t      _current_gain;
 106         nframes_t   _output_offset;
 107         bool        _no_outs_cuz_we_no_monitor;
 108         uint32_t    _solo_level;
 109         bool        _solo_isolated;
 110         boost::shared_ptr<MuteMaster> _mute_master;
 111         bool         no_panner_reset;
 112         boost::shared_ptr<Panner> _panner;
 113
 114         static bool panners_legal;
 115         static sigc::signal<int>            PannersLegal;
 116
 117         int panners_became_legal ();
 118         sigc::connection panner_legal_c;
 119         void output_changed (IOChange, void*);
 120
 121         gain_t target_gain ();
 122 };
 123
 124
 125 } // namespace ARDOUR
 126
 127 #endif // __ardour__h__
 128