Exact beat - provide audio->music mapping for region split.
[ardour.git] / libs / ardour / ardour / port.h
index 45256a61fec0791d2aed6f33ea6754617ca4ea61..619b8ba0f2dfb729fb2e8242467c4d0454fbca63 100644 (file)
 #ifndef __ardour_port_h__
 #define __ardour_port_h__
 
+#include "libardour-config.h"
+
 #include <set>
 #include <string>
 #include <vector>
-#include <jack/jack.h>
 #include <boost/utility.hpp>
 #include "pbd/signals.h"
 
 #include "ardour/data_type.h"
+#include "ardour/port_engine.h"
+#include "ardour/libardour_visibility.h"
 #include "ardour/types.h"
 
 namespace ARDOUR {
@@ -35,23 +38,15 @@ namespace ARDOUR {
 class AudioEngine;
 class Buffer;
 
-class Port : public boost::noncopyable
+class LIBARDOUR_API Port : public boost::noncopyable
 {
 public:
-       enum Flags {
-               IsInput = JackPortIsInput,
-               IsOutput = JackPortIsOutput,
-       };
-
        virtual ~Port ();
 
-       static void set_buffer_size (pframes_t sz) {
-               _buffer_size = sz;
-       }
-       static void set_connecting_blocked( bool yn ) { 
+       static void set_connecting_blocked( bool yn ) {
                _connecting_blocked = yn;
        }
-       static bool connecting_blocked() { 
+       static bool connecting_blocked() {
                return _connecting_blocked;
        }
 
@@ -60,10 +55,14 @@ public:
                return _name;
        }
 
+       /** @return Port human readable name */
+       std::string pretty_name (bool fallback_to_name = false) const;
+       bool set_pretty_name (const std::string&);
+
        int set_name (std::string const &);
 
        /** @return flags */
-       Flags flags () const {
+       PortFlags flags () const {
                return _flags;
        }
 
@@ -91,63 +90,91 @@ public:
        virtual int connect (Port *);
        int disconnect (Port *);
 
-       void ensure_monitor_input (bool);
+       void request_input_monitoring (bool);
+       void ensure_input_monitoring (bool);
        bool monitoring_input () const;
-       framecnt_t total_latency () const;
        int reestablish ();
        int reconnect ();
-       void request_monitor_input (bool);
-       void set_latency (framecnt_t);
-        
-        void get_connected_latency_range (jack_latency_range_t& range, jack_latency_callback_mode_t mode) const;
-        void set_latency_range (jack_latency_range_t& range, jack_latency_callback_mode_t mode) const;
 
-       virtual void reset ();
+       bool last_monitor() const { return _last_monitor; }
+       void set_last_monitor (bool yn) { _last_monitor = yn; }
+
+       PortEngine::PortHandle port_handle() { return _port_handle; }
 
-       /** @return the size of the raw buffer (bytes) for duration @a nframes (audio frames) */
-       virtual size_t raw_buffer_size (pframes_t nframes) const = 0;
+       void get_connected_latency_range (LatencyRange& range, bool playback) const;
+
+       void set_private_latency_range (LatencyRange& range, bool playback);
+       const LatencyRange&  private_latency_range (bool playback) const;
+
+       void set_public_latency_range (LatencyRange& range, bool playback) const;
+       LatencyRange public_latency_range (bool playback) const;
+
+       virtual void reset ();
 
        virtual DataType type () const = 0;
-       virtual void cycle_start (pframes_t) = 0;
+       virtual void cycle_start (pframes_t);
        virtual void cycle_end (pframes_t) = 0;
        virtual void cycle_split () = 0;
-       virtual Buffer& get_buffer (framecnt_t nframes, framecnt_t offset = 0) = 0;
-       virtual void flush_buffers (pframes_t nframes, framepos_t /*time*/, framecnt_t offset = 0) {
-               assert (offset < nframes);
-       }
+       virtual Buffer& get_buffer (pframes_t nframes) = 0;
+       virtual void flush_buffers (pframes_t /*nframes*/) {}
        virtual void transport_stopped () {}
+       virtual void realtime_locate () {}
 
-        bool physically_connected () const;
-
-       static void set_engine (AudioEngine *);
+       bool physically_connected () const;
 
        PBD::Signal1<void,bool> MonitorInputChanged;
+       static PBD::Signal2<void,boost::shared_ptr<Port>,boost::shared_ptr<Port> > PostDisconnect;
+       static PBD::Signal0<void> PortDrop;
+       static PBD::Signal0<void> PortSignalDrop;
+
+       static void set_cycle_framecnt (pframes_t n) {
+               _cycle_nframes = n;
+       }
+       static framecnt_t port_offset() { return _global_port_buffer_offset; }
+       static void set_global_port_buffer_offset (pframes_t off) {
+               _global_port_buffer_offset = off;
+       }
+       static void increment_global_port_buffer_offset (pframes_t n) {
+               _global_port_buffer_offset += n;
+       }
+
+       virtual void increment_port_buffer_offset (pframes_t n);
+
+       virtual XMLNode& get_state (void) const;
+       virtual int set_state (const XMLNode&, int version);
+
+        static std::string state_node_name;
 
 protected:
 
-       Port (std::string const &, DataType, Flags);
+       Port (std::string const &, DataType, PortFlags);
 
-       jack_port_t* _jack_port; ///< JACK port
+        PortEngine::PortHandle _port_handle;
 
-       static pframes_t  _buffer_size;
        static bool       _connecting_blocked;
-        
-       static AudioEngine* _engine; ///< the AudioEngine
-
-private:
-       friend class AudioEngine;
+       static pframes_t  _global_port_buffer_offset;   /* access only from process() tree */
+       static pframes_t  _cycle_nframes; /* access only from process() tree */
 
-       void recompute_total_latency () const;
+       framecnt_t _port_buffer_offset; /* access only from process() tree */
 
-       /* XXX */
-       bool _last_monitor;
+       LatencyRange _private_playback_latency;
+       LatencyRange _private_capture_latency;
 
+private:
        std::string _name;  ///< port short name
-       Flags       _flags; ///< flags
+       PortFlags       _flags; ///< flags
+       bool        _last_monitor;
 
        /** ports that we are connected to, kept so that we can
-           reconnect to JACK when required */
+           reconnect to the backend when required
+       */
        std::set<std::string> _connections;
+
+       void port_connected_or_disconnected (boost::weak_ptr<Port>, boost::weak_ptr<Port>, bool);
+       void signal_drop ();
+       void drop ();
+       PBD::ScopedConnection drop_connection;
+       PBD::ScopedConnection engine_connection;
 };
 
 }