libs/ardour/ardour/port.h

   1 /*
   2     Copyright (C) 2002 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17
  18     $Id$
  19 */
  20
  21 #ifndef __ardour_port_h__
  22 #define __ardour_port_h__
  23
  24 #include <sigc++/signal.h>
  25 #include <pbd/failed_constructor.h>
  26 #include <ardour/ardour.h>
  27 #include <ardour/data_type.h>
  28 #include <jack/jack.h>
  29
  30 namespace ARDOUR {
  31
  32 class AudioEngine;
  33 class Buffer;
  34
  35 /** Abstract base for all outside ports (eg Jack ports)
  36  */
  37 class Port : public sigc::trackable {
  38    public:
  39         virtual ~Port() {
  40                 free (_port);
  41         }
  42
  43         virtual DataType type() const = 0;
  44
  45         virtual void cycle_start(jack_nframes_t nframes) {}
  46         virtual void cycle_end() {}
  47
  48         virtual Buffer& get_buffer() = 0;
  49
  50         std::string name() const {
  51                 return _name;
  52         }
  53
  54         std::string short_name() {
  55                 return jack_port_short_name (_port);
  56         }
  57
  58         int set_name (std::string str);
  59
  60         JackPortFlags flags() const {
  61                 return _flags;
  62         }
  63
  64         bool is_mine (jack_client_t *client) {
  65                 return jack_port_is_mine (client, _port);
  66         }
  67
  68         int connected () const {
  69                 return jack_port_connected (_port);
  70         }
  71
  72         bool connected_to (const std::string& portname) const {
  73                 return jack_port_connected_to (_port, portname.c_str());
  74         }
  75
  76         const char ** get_connections () const {
  77                 return jack_port_get_connections (_port);
  78         }
  79
  80         bool receives_input() const {
  81                 return _flags & JackPortIsInput;
  82         }
  83
  84         bool sends_output () const {
  85                 return _flags & JackPortIsOutput;
  86         }
  87
  88         bool monitoring_input () const {
  89                 return jack_port_monitoring_input (_port);
  90         }
  91
  92         bool can_monitor () const {
  93                 return _flags & JackPortCanMonitor;
  94         }
  95
  96         void enable_metering() {
  97                 _metering++;
  98         }
  99
 100         void disable_metering () {
 101                 if (_metering) { _metering--; }
 102         }
 103
 104         void ensure_monitor_input (bool yn) {
 105
 106 #ifdef HAVE_JACK_PORT_ENSURE_MONITOR
 107                 jack_port_ensure_monitor (_port, yn);
 108 #else
 109                 jack_port_request_monitor(_port, yn);
 110 #endif
 111
 112         }
 113
 114         /*XXX completely bloody useless imho*/
 115         void request_monitor_input (bool yn) {
 116                 jack_port_request_monitor (_port, yn);
 117         }
 118
 119         nframes_t latency () const {
 120                 return jack_port_get_latency (_port);
 121         }
 122
 123         void set_latency (nframes_t nframes) {
 124                 jack_port_set_latency (_port, nframes);
 125         }
 126
 127         sigc::signal<void,bool> MonitorInputChanged;
 128         sigc::signal<void,bool> ClockSyncChanged;
 129
 130   protected:
 131         friend class AudioEngine;
 132
 133         Port (jack_port_t *port);
 134
 135         virtual void reset ();
 136
 137         /* engine isn't supposed to access below here */
 138
 139         /* cache these 3 from JACK so we can access them for reconnecting */
 140         JackPortFlags _flags;
 141         std::string   _type;
 142         std::string   _name;
 143
 144         jack_port_t*  _port;
 145
 146         unsigned short _metering;
 147
 148         bool          _last_monitor : 1;
 149 };
 150
 151 } // namespace ARDOUR
 152
 153 #endif /* __ardour_port_h__ */