extensive changes to PresentationInfo API
[ardour.git] / libs / ardour / internal_send.cc
index 7fc2efe9b9d315c7aef54062343ef8c58afc79a1..1c42993d4fa91247b2cce263507c4f4a58c939d0 100644 (file)
 
 */
 
-#include <iostream>
-
 #include "pbd/error.h"
 #include "pbd/failed_constructor.h"
 
 #include "ardour/amp.h"
+#include "ardour/audio_buffer.h"
+#include "ardour/internal_return.h"
 #include "ardour/internal_send.h"
 #include "ardour/meter.h"
+#include "ardour/panner_shell.h"
 #include "ardour/route.h"
 #include "ardour/session.h"
+#include "ardour/audioengine.h"
 
 #include "i18n.h"
 
+namespace ARDOUR { class MuteMaster; class Pannable; }
+
 using namespace PBD;
 using namespace ARDOUR;
-
-InternalSend::InternalSend (Session& s, boost::shared_ptr<MuteMaster> mm, boost::shared_ptr<Route> sendto, Delivery::Role role)
-       : Send (s, mm, role)
-       , _send_to (sendto)
+using namespace std;
+
+PBD::Signal1<void, pframes_t> InternalSend::CycleStart;
+
+InternalSend::InternalSend (Session& s,
+               boost::shared_ptr<Pannable> p,
+               boost::shared_ptr<MuteMaster> mm,
+               boost::shared_ptr<Route> sendfrom,
+               boost::shared_ptr<Route> sendto,
+               Delivery::Role role,
+               bool ignore_bitslot)
+       : Send (s, p, mm, role, ignore_bitslot)
+       , _send_from (sendfrom)
 {
-       if ((target = _send_to->get_return_buffer ()) == 0) {
-               throw failed_constructor();
+       if (sendto) {
+               if (use_target (sendto)) {
+                       throw failed_constructor();
+               }
        }
 
-       set_name (sendto->name());
+       init_gain ();
 
-       _send_to->GoingAway.connect (*this, boost::bind (&InternalSend::send_to_going_away, this));
-       _send_to->NameChanged.connect (*this, boost::bind (&InternalSend::send_to_name_changed, this));
+       _send_from->DropReferences.connect_same_thread (source_connection, boost::bind (&InternalSend::send_from_going_away, this));
+       CycleStart.connect_same_thread (*this, boost::bind (&InternalSend::cycle_start, this, _1));
 }
 
-InternalSend::InternalSend (Session& s, boost::shared_ptr<MuteMaster> mm, const XMLNode& node)
-       : Send (s, mm, node, Stateful::loading_state_version, Delivery::Aux /* will be reset in set_state() */),
-         target (0)
+InternalSend::~InternalSend ()
 {
-       /* Send constructor will set its state, so here we just need to set up our own */
-       set_our_state (node, Stateful::loading_state_version);
+       if (_send_to) {
+               _send_to->remove_send_from_internal_return (this);
+       }
 }
 
-InternalSend::~InternalSend ()
+void
+InternalSend::init_gain ()
+{
+       if (_role == Listen) {
+               /* send to monitor bus is always at unity */
+               _gain_control->set_value (GAIN_COEFF_UNITY, PBD::Controllable::NoGroup);
+       } else {
+               /* aux sends start at -inf dB */
+               _gain_control->set_value (GAIN_COEFF_ZERO, PBD::Controllable::NoGroup);
+       }
+}
+
+int
+InternalSend::use_target (boost::shared_ptr<Route> sendto)
 {
        if (_send_to) {
-               _send_to->release_return_buffer ();
+               _send_to->remove_send_from_internal_return (this);
        }
 
-       connect_c.disconnect ();
+        _send_to = sendto;
+
+        _send_to->add_send_to_internal_return (this);
+
+       mixbufs.ensure_buffers (_send_to->internal_return()->input_streams(), _session.get_block_size());
+       mixbufs.set_count (_send_to->internal_return()->input_streams());
+
+       reset_panner ();
+
+        set_name (sendto->name());
+        _send_to_id = _send_to->id();
+
+        target_connections.drop_connections ();
+
+        _send_to->DropReferences.connect_same_thread (target_connections, boost::bind (&InternalSend::send_to_going_away, this));
+        _send_to->PropertyChanged.connect_same_thread (target_connections, boost::bind (&InternalSend::send_to_property_changed, this, _1));
+        _send_to->io_changed.connect_same_thread (target_connections, boost::bind (&InternalSend::target_io_changed, this));
+
+        return 0;
+}
+
+void
+InternalSend::target_io_changed ()
+{
+       assert (_send_to);
+       mixbufs.ensure_buffers (_send_to->internal_return()->input_streams(), _session.get_block_size());
+       mixbufs.set_count (_send_to->internal_return()->input_streams());
+       reset_panner();
+}
+
+void
+InternalSend::send_from_going_away ()
+{
+       _send_from.reset();
 }
 
 void
 InternalSend::send_to_going_away ()
 {
-       target = 0;
+        target_connections.drop_connections ();
        _send_to.reset ();
        _send_to_id = "0";
 }
 
 void
-InternalSend::run (BufferSet& bufs, sframes_t start_frame, sframes_t end_frame, nframes_t nframes, bool)
+InternalSend::run (BufferSet& bufs, framepos_t start_frame, framepos_t end_frame, pframes_t nframes, bool)
 {
-       if ((!_active && !_pending_active) || !target || !_send_to) {
+       if ((!_active && !_pending_active) || !_send_to) {
                _meter->reset ();
                return;
        }
@@ -83,8 +143,48 @@ InternalSend::run (BufferSet& bufs, sframes_t start_frame, sframes_t end_frame,
        // we have to copy the input, because we may alter the buffers with the amp
        // in-place, which a send must never do.
 
-       assert(mixbufs.available() >= bufs.count());
-       mixbufs.read_from (bufs, nframes);
+       if (_panshell && !_panshell->bypassed() && role() != Listen) {
+               _panshell->run (bufs, mixbufs, start_frame, end_frame, nframes);
+       } else {
+               if (role() == Listen) {
+                       /* We're going to the monitor bus, so discard MIDI data */
+
+                       uint32_t const bufs_audio = bufs.count().get (DataType::AUDIO);
+                       uint32_t const mixbufs_audio = mixbufs.count().get (DataType::AUDIO);
+
+                       /* monitor-section has same number of channels as master-bus (on creation).
+                        *
+                        * There is no clear answer what should happen when trying to PFL or AFL
+                        * a track that has more channels (bufs_audio from source-track is
+                        * larger than mixbufs).
+                        *
+                        * There are two options:
+                        *  1: discard additional channels    (current)
+                        * OR
+                        *  2: require the monitor-section to have at least as many channels
+                        * as the largest count of any route
+                        */
+                       //assert (mixbufs.available().get (DataType::AUDIO) >= bufs_audio);
+
+                       /* Copy bufs into mixbufs, going round bufs more than once if necessary
+                          to ensure that every mixbuf gets some data.
+                       */
+
+                       uint32_t j = 0;
+                       for (uint32_t i = 0; i < mixbufs_audio; ++i) {
+                               mixbufs.get_audio(i).read_from (bufs.get_audio(j), nframes);
+                               ++j;
+
+                               if (j == bufs_audio) {
+                                       j = 0;
+                               }
+                       }
+
+               } else {
+                       assert (mixbufs.available() >= bufs.count());
+                       mixbufs.read_from (bufs, nframes);
+               }
+       }
 
        /* gain control */
 
@@ -94,54 +194,53 @@ InternalSend::run (BufferSet& bufs, sframes_t start_frame, sframes_t end_frame,
 
                /* target gain has changed */
 
-               Amp::apply_gain (mixbufs, nframes, _current_gain, tgain);
-               _current_gain = tgain;
+               _current_gain = Amp::apply_gain (mixbufs, _session.nominal_frame_rate(), nframes, _current_gain, tgain);
 
-       } else if (tgain == 0.0) {
+       } else if (tgain == GAIN_COEFF_ZERO) {
 
                /* we were quiet last time, and we're still supposed to be quiet.
                */
 
                _meter->reset ();
-               Amp::apply_simple_gain (mixbufs, nframes, 0.0);
+               Amp::apply_simple_gain (mixbufs, nframes, GAIN_COEFF_ZERO);
                goto out;
 
-       } else if (tgain != 1.0) {
+       } else if (tgain != GAIN_COEFF_UNITY) {
 
                /* target gain has not changed, but is not zero or unity */
                Amp::apply_simple_gain (mixbufs, nframes, tgain);
        }
 
-       // Can't automate gain for sends or returns yet because we need different buffers
-       // so that we don't overwrite the main automation data for the route amp
-       // _amp->setup_gain_automation (start_frame, end_frame, nframes);
-
+       _amp->set_gain_automation_buffer (_session.send_gain_automation_buffer ());
+       _amp->setup_gain_automation (start_frame, end_frame, nframes);
        _amp->run (mixbufs, start_frame, end_frame, nframes, true);
 
-       /* XXX NEED TO PAN */
+       _delayline->run (mixbufs, start_frame, end_frame, nframes, true);
 
        /* consider metering */
 
        if (_metering) {
-               if (_amp->gain_control()->get_value() == 0) {
+               if (_amp->gain_control()->get_value() == GAIN_COEFF_ZERO) {
                        _meter->reset();
                } else {
                        _meter->run (mixbufs, start_frame, end_frame, nframes, true);
                }
        }
 
-       /* deliver to target */
-
-       target->merge_from (mixbufs, nframes);
+       /* target will pick up our output when it is ready */
 
   out:
        _active = _pending_active;
 }
 
-void
-InternalSend::set_block_size (nframes_t nframes)
+int
+InternalSend::set_block_size (pframes_t nframes)
 {
-       mixbufs.ensure_buffers (_configured_input, nframes);
+       if (_send_to) {
+               mixbufs.ensure_buffers (_send_to->internal_return()->input_streams(), nframes);
+       }
+
+        return 0;
 }
 
 bool
@@ -173,9 +272,13 @@ InternalSend::get_state()
 }
 
 int
-InternalSend::set_our_state (const XMLNode& node, int version)
+InternalSend::set_state (const XMLNode& node, int version)
 {
-       const XMLProperty* prop;
+       XMLProperty const * prop;
+
+       init_gain ();
+
+       Send::set_state (node, version);
 
        if ((prop = node.property ("target")) != 0) {
 
@@ -187,7 +290,7 @@ InternalSend::set_our_state (const XMLNode& node, int version)
                */
 
                if (!IO::connecting_legal) {
-                       IO::ConnectingLegal.connect (connect_c, boost::bind (&InternalSend::connect_when_legal, this));
+                       IO::ConnectingLegal.connect_same_thread (connect_c, boost::bind (&InternalSend::connect_when_legal, this));
                } else {
                        connect_when_legal ();
                }
@@ -196,13 +299,6 @@ InternalSend::set_our_state (const XMLNode& node, int version)
        return 0;
 }
 
-int
-InternalSend::set_state (const XMLNode& node, int version)
-{
-       Send::set_state (node, version);
-       return set_our_state (node, version);
-}
-
 int
 InternalSend::connect_when_legal ()
 {
@@ -213,46 +309,60 @@ InternalSend::connect_when_legal ()
                return 0;
        }
 
-       if ((_send_to = _session.route_by_id (_send_to_id)) == 0) {
-               error << X_("cannot find route to connect to") << endmsg;
-               return -1;
-       }
+        boost::shared_ptr<Route> sendto;
 
-       if ((target = _send_to->get_return_buffer ()) == 0) {
-               error << X_("target for internal send has no return buffer") << endmsg;
+       if ((sendto = _session.route_by_id (_send_to_id)) == 0) {
+               error << string_compose (_("%1 - cannot find any track/bus with the ID %2 to connect to"), display_name(), _send_to_id) << endmsg;
+               cerr << string_compose (_("%1 - cannot find any track/bus with the ID %2 to connect to"), display_name(), _send_to_id) << endl;
                return -1;
        }
 
-       return 0;
+        return use_target (sendto);
 }
 
 bool
-InternalSend::can_support_io_configuration (const ChanCount& in, ChanCount& out) const
+InternalSend::can_support_io_configuration (const ChanCount& in, ChanCount& out)
 {
        out = in;
        return true;
 }
 
+uint32_t
+InternalSend::pan_outs () const
+{
+       /* the number of targets for our panner is determined by what we are
+          sending to, if anything.
+       */
+
+       if (_send_to) {
+               return _send_to->internal_return()->input_streams().n_audio();
+       }
+
+       return 1; /* zero is more accurate, but 1 is probably safer as a way to
+                  * say "don't pan"
+                  */
+}
+
 bool
 InternalSend::configure_io (ChanCount in, ChanCount out)
 {
        bool ret = Send::configure_io (in, out);
-       set_block_size (_session.engine().frames_per_cycle());
+       set_block_size (_session.engine().samples_per_cycle());
        return ret;
 }
 
 bool
-InternalSend::set_name (const std::string& str)
+InternalSend::set_name (const string& str)
 {
        /* rules for external sends don't apply to us */
        return IOProcessor::set_name (str);
 }
 
-std::string
+string
 InternalSend::display_name () const
 {
        if (_role == Aux) {
-               return string_compose (X_("aux-%1"), _name);
+               return string_compose (X_("%1"), _name);
        } else {
                return _name;
        }
@@ -269,7 +379,25 @@ InternalSend::visible () const
 }
 
 void
-InternalSend::send_to_name_changed ()
+InternalSend::send_to_property_changed (const PropertyChange& what_changed)
+{
+       if (what_changed.contains (Properties::name)) {
+               set_name (_send_to->name ());
+       }
+}
+
+void
+InternalSend::set_can_pan (bool yn)
 {
-       set_name (_send_to->name ());
+       if (_panshell) {
+               _panshell->set_bypassed (!yn);
+       }
+}
+
+void
+InternalSend::cycle_start (pframes_t /*nframes*/)
+{
+       for (BufferSet::audio_iterator b = mixbufs.audio_begin(); b != mixbufs.audio_end(); ++b) {
+               b->prepare ();
+       }
 }