2 Copyright (C) 2000 Paul Davis
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.
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.
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.
20 #ifndef __ardour_io_h__
21 #define __ardour_io_h__
26 #include <sigc++/signal.h>
27 #include <jack/jack.h>
29 #include <glibmm/thread.h>
31 #include "pbd/fastlog.h"
33 #include "pbd/statefuldestructible.h"
34 #include "pbd/controllable.h"
36 #include "ardour/ardour.h"
37 #include "ardour/automatable_controls.h"
38 #include "ardour/automation_control.h"
39 #include "ardour/bundle.h"
40 #include "ardour/chan_count.h"
41 #include "ardour/data_type.h"
42 #include "ardour/latent.h"
43 #include "ardour/port_set.h"
44 #include "ardour/session_object.h"
45 #include "ardour/types.h"
46 #include "ardour/utils.h"
64 /** A collection of ports (all input or all output) with connections.
66 * An IO can contain ports of varying types, making routes/inserts/etc with
67 * varied combinations of types (eg MIDI and audio) possible.
69 class IO : public SessionObject, public Latent
72 static const std::string state_node_name;
79 IO (Session&, const std::string& name, Direction, DataType default_type = DataType::AUDIO);
80 IO (Session&, const XMLNode&, DataType default_type = DataType::AUDIO);
84 Direction direction() const { return _direction; }
86 DataType default_type() const { return _default_type; }
87 void set_default_type(DataType t) { _default_type = t; }
89 bool active() const { return _active; }
90 void set_active(bool yn) { _active = yn; }
92 bool set_name (const std::string& str);
94 virtual void silence (nframes_t);
96 int ensure_io (ChanCount cnt, bool clear, void *src);
98 int connect_ports_to_bundle (boost::shared_ptr<Bundle>, void *);
99 int disconnect_ports_from_bundle (boost::shared_ptr<Bundle>, void *);
101 BundleList bundles_connected ();
103 boost::shared_ptr<Bundle> bundle () { return _bundle; }
105 int add_port (std::string connection, void *src, DataType type = DataType::NIL);
106 int remove_port (Port *, void *src);
107 int connect (Port *our_port, std::string other_port, void *src);
108 int disconnect (Port *our_port, std::string other_port, void *src);
109 int disconnect (void *src);
110 bool connected_to (boost::shared_ptr<const IO>) const;
112 nframes_t signal_latency() const { return _own_latency; }
113 nframes_t latency() const;
114 void set_port_latency (nframes_t);
116 void update_port_total_latencies ();
118 PortSet& ports() { return _ports; }
119 const PortSet& ports() const { return _ports; }
121 Port *nth (uint32_t n) const {
122 if (n < _ports.num_ports()) {
123 return _ports.port(n);
129 Port* port_by_name (const std::string& str) const;
131 AudioPort* audio(uint32_t n) const;
132 MidiPort* midi(uint32_t n) const;
134 const ChanCount& n_ports () const { return _ports.count(); }
136 sigc::signal<void,IOChange,void*> changed;
138 virtual XMLNode& state (bool full);
139 XMLNode& get_state (void);
140 int set_state (const XMLNode&);
142 static int disable_connecting (void);
143 static int enable_connecting (void);
144 static int disable_ports (void);
145 static int enable_ports (void);
147 static sigc::signal<void,ChanCount> PortCountChanged; // emitted when the number of ports changes
149 static std::string name_from_state (const XMLNode&);
150 static void set_name_in_state (XMLNode&, const std::string&);
152 /* we have to defer/order port connection. this is how we do it.
155 static sigc::signal<int> ConnectingLegal;
156 static bool connecting_legal;
158 XMLNode *pending_state_node;
160 /* three utility functions - this just seems to be simplest place to put them */
162 void collect_input (BufferSet& bufs, nframes_t nframes, ChanCount offset);
163 void process_input (boost::shared_ptr<Processor>, sframes_t start_frame, sframes_t end_frame, nframes_t nframes);
164 void copy_to_outputs (BufferSet& bufs, DataType type, nframes_t nframes, nframes_t offset);
166 /* AudioTrack::deprecated_use_diskstream_connections() needs these */
168 int set_ports (const std::string& str);
171 mutable Glib::Mutex io_lock;
175 Direction _direction;
176 DataType _default_type;
181 int connecting_became_legal ();
182 sigc::connection connection_legal_c;
184 boost::shared_ptr<Bundle> _bundle; ///< a bundle representing our ports
186 struct UserBundleInfo {
187 UserBundleInfo (IO*, boost::shared_ptr<UserBundle> b);
189 boost::shared_ptr<UserBundle> bundle;
190 sigc::connection changed;
193 std::vector<UserBundleInfo> _bundles_connected; ///< user bundles connected to our ports
195 static int parse_io_string (const std::string&, std::vector<std::string>& chns);
196 static int parse_gain_string (const std::string&, std::vector<std::string>& chns);
198 int ensure_ports (ChanCount, bool clear, bool lockit, void *src);
200 void check_bundles_connected ();
201 void check_bundles (std::vector<UserBundleInfo>&, const PortSet&);
203 void bundle_changed (Bundle::Change);
206 int get_port_counts (const XMLNode& node, ChanCount& n, boost::shared_ptr<Bundle>& c);
207 int create_ports (const XMLNode&);
208 int make_connections (const XMLNode&);
210 boost::shared_ptr<Bundle> find_possible_bundle (const std::string &desired_name);
212 bool ensure_ports_locked (ChanCount, bool clear, void *src);
214 std::string build_legal_port_name (DataType type);
215 int32_t find_port_hole (const char* base);
217 void setup_bundles ();
218 std::string bundle_channel_name (uint32_t, uint32_t) const;
221 } // namespace ARDOUR
223 #endif /*__ardour_io_h__ */