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
  24 #include "ardour/libardour_visibility.h"
  25 #include "ardour/types.h"
  26 #include "ardour/chan_count.h"
  27 #include "ardour/io_processor.h"
  28
  29 namespace ARDOUR {
  30
  31 class BufferSet;
  32 class IO;
  33 class MuteMaster;
  34 class PannerShell;
  35 class Panner;
  36 class Pannable;
  37
  38 class LIBARDOUR_API Delivery : public IOProcessor
  39 {
  40 public:
  41         enum Role {
  42                 /* main outputs - delivers out-of-place to port buffers, and cannot be removed */
  43                 Main   = 0x1,
  44                 /* send - delivers to port buffers, leaves input buffers untouched */
  45                 Send   = 0x2,
  46                 /* insert - delivers to port buffers and receives in-place from port buffers */
  47                 Insert = 0x4,
  48                 /* listen - internal send used only to deliver to control/monitor bus */
  49                 Listen = 0x8,
  50                 /* aux - internal send used to deliver to any bus, by user request */
  51                 Aux    = 0x10
  52         };
  53
  54         static bool role_requires_output_ports (Role r) { return r == Main || r == Send || r == Insert; }
  55
  56         bool does_routing() const { return true; }
  57
  58         /* Delivery to an existing output */
  59
  60         Delivery (Session& s, boost::shared_ptr<IO> io, boost::shared_ptr<Pannable>, boost::shared_ptr<MuteMaster> mm, const std::string& name, Role);
  61
  62         /* Delivery to a new output owned by this object */
  63
  64         Delivery (Session& s, boost::shared_ptr<Pannable>, boost::shared_ptr<MuteMaster> mm, const std::string& name, Role);
  65         ~Delivery ();
  66
  67         bool set_name (const std::string& name);
  68         std::string display_name() const;
  69
  70         Role role() const { return _role; }
  71         bool can_support_io_configuration (const ChanCount& in, ChanCount& out);
  72         bool configure_io (ChanCount in, ChanCount out);
  73
  74         void run (BufferSet& bufs, samplepos_t start_sample, samplepos_t end_sample, double speed, pframes_t nframes, bool);
  75
  76         /* supplemental method used with MIDI */
  77
  78         void flush_buffers (samplecnt_t nframes);
  79         void no_outs_cuz_we_no_monitor(bool);
  80         void non_realtime_transport_stop (samplepos_t now, bool flush);
  81         void realtime_locate ();
  82
  83         BufferSet& output_buffers() { return *_output_buffers; }
  84
  85         PBD::Signal0<void> MuteChange;
  86
  87         int set_state (const XMLNode&, int version);
  88
  89         /* Panning */
  90
  91         static int  disable_panners (void);
  92         static void reset_panners ();
  93
  94         boost::shared_ptr<PannerShell> panner_shell() const { return _panshell; }
  95         boost::shared_ptr<Panner> panner() const;
  96
  97         void unpan ();
  98         void reset_panner ();
  99         void defer_pan_reset ();
 100         void allow_pan_reset ();
 101
 102         uint32_t pans_required() const { return _configured_input.n_audio(); }
 103         virtual uint32_t pan_outs() const;
 104
 105 protected:
 106         XMLNode& state ();
 107
 108         Role        _role;
 109         BufferSet*  _output_buffers;
 110         gain_t      _current_gain;
 111         boost::shared_ptr<PannerShell> _panshell;
 112
 113         gain_t target_gain ();
 114
 115 private:
 116         bool        _no_outs_cuz_we_no_monitor;
 117         boost::shared_ptr<MuteMaster> _mute_master;
 118
 119         static bool panners_legal;
 120         static PBD::Signal0<void> PannersLegal;
 121
 122         void panners_became_legal ();
 123         PBD::ScopedConnection panner_legal_c;
 124         void output_changed (IOChange, void*);
 125
 126         bool _no_panner_reset;
 127 };
 128
 129
 130 } // namespace ARDOUR
 131
 132 #endif // __ardour__h__
 133