2 Copyright (C) 2006 Paul Davis
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)
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
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.
19 #ifndef __ardour_delivery_h__
20 #define __ardour_delivery_h__
24 #include "ardour/types.h"
25 #include "ardour/chan_count.h"
26 #include "ardour/io_processor.h"
35 class Delivery : public IOProcessor
39 /* main outputs - delivers out-of-place to port buffers, and cannot be removed */
41 /* send - delivers to port buffers, leaves input buffers untouched */
43 /* insert - delivers to port buffers and receives in-place from port buffers */
45 /* listen - internal send used only to deliver to control/monitor bus */
47 /* aux - internal send used to deliver to any bus, by user request */
51 static bool role_requires_output_ports (Role r) { return r == Main || r == Send || r == Insert; }
53 /* Delivery to an existing output */
55 Delivery (Session& s, boost::shared_ptr<IO> io, boost::shared_ptr<MuteMaster> mm, const std::string& name, Role);
56 Delivery (Session& s, boost::shared_ptr<IO> io, boost::shared_ptr<MuteMaster> mm, const XMLNode&);
58 /* Delivery to a new output owned by this object */
60 Delivery (Session& s, boost::shared_ptr<MuteMaster> mm, const std::string& name, Role);
61 Delivery (Session&, boost::shared_ptr<MuteMaster> mm, const XMLNode&);
63 bool set_name (const std::string& name);
64 std::string display_name() const;
66 Role role() const { return _role; }
67 bool can_support_io_configuration (const ChanCount& in, ChanCount& out) const;
68 bool configure_io (ChanCount in, ChanCount out);
70 void run (BufferSet& bufs, sframes_t start_frame, sframes_t end_frame, nframes_t nframes, bool);
72 /* supplemental method used with MIDI */
74 void flush (nframes_t nframes, nframes64_t time);
75 void transport_stopped ();
77 void no_outs_cuz_we_no_monitor(bool);
79 void set_solo_level (int32_t sl) { _solo_level = sl; }
80 void set_solo_isolated (bool yn) { _solo_isolated = yn; }
82 void cycle_start (nframes_t);
83 void increment_output_offset (nframes_t);
84 void transport_stopped (sframes_t frame);
86 BufferSet& output_buffers() { return *_output_buffers; }
88 boost::signals2::signal<void()> MuteChange;
90 static boost::signals2::signal<void(nframes_t)> CycleStart;
92 XMLNode& state (bool full);
93 int set_state (const XMLNode&, int version);
97 static int disable_panners (void);
98 static int reset_panners (void);
100 boost::shared_ptr<Panner> panner() const { return _panner; }
102 void reset_panner ();
103 void defer_pan_reset ();
104 void allow_pan_reset ();
106 uint32_t pans_required() const { return _configured_input.n_audio(); }
107 void start_pan_touch (uint32_t which);
108 void end_pan_touch (uint32_t which);
112 BufferSet* _output_buffers;
113 gain_t _current_gain;
114 nframes_t _output_offset;
115 bool _no_outs_cuz_we_no_monitor;
116 uint32_t _solo_level;
118 boost::shared_ptr<MuteMaster> _mute_master;
119 bool no_panner_reset;
120 boost::shared_ptr<Panner> _panner;
122 static bool panners_legal;
123 static boost::signals2::signal<int()> PannersLegal;
125 int panners_became_legal ();
126 boost::signals2::scoped_connection panner_legal_c;
127 void output_changed (IOChange, void*);
129 gain_t target_gain ();
133 } // namespace ARDOUR
135 #endif // __ardour__h__