add some horz and vert zoom actions; remove some whitespace from the code of the...
[ardour.git] / libs / surfaces / osc / osc.cc
1 /*
2  * Copyright (C) 2006 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
17  *
18  */
19
20 #include <cstdio>
21 #include <cstdlib>
22 #include <cerrno>
23 #include <algorithm>
24
25 #include <unistd.h>
26 #include <fcntl.h>
27
28 #include "pbd/gstdio_compat.h"
29 #include <glibmm/miscutils.h>
30
31 #include <pbd/convert.h>
32 #include <pbd/pthread_utils.h>
33 #include <pbd/file_utils.h>
34 #include <pbd/failed_constructor.h>
35
36 #include "ardour/amp.h"
37 #include "ardour/session.h"
38 #include "ardour/route.h"
39 #include "ardour/audio_track.h"
40 #include "ardour/midi_track.h"
41 #include "ardour/dB.h"
42 #include "ardour/filesystem_paths.h"
43 #include "ardour/panner.h"
44 #include "ardour/plugin.h"
45 #include "ardour/plugin_insert.h"
46 #include "ardour/send.h"
47
48 #include "osc.h"
49 #include "osc_controllable.h"
50 #include "osc_route_observer.h"
51 #include "i18n.h"
52
53 using namespace ARDOUR;
54 using namespace std;
55 using namespace Glib;
56 using namespace ArdourSurface;
57
58 #include "pbd/abstract_ui.cc" // instantiate template
59
60 OSC* OSC::_instance = 0;
61
62 #ifdef DEBUG
63 static void error_callback(int num, const char *m, const char *path)
64 {
65         fprintf(stderr, "liblo server error %d in path %s: %s\n", num, path, m);
66 }
67 #else
68 static void error_callback(int, const char *, const char *)
69 {
70
71 }
72 #endif
73
74 OSC::OSC (Session& s, uint32_t port)
75         : ControlProtocol (s, X_("Open Sound Control (OSC)"))
76         , AbstractUI<OSCUIRequest> (name())
77         , local_server (0)
78         , remote_server (0)
79         , _port(port)
80         , _ok (true)
81         , _shutdown (false)
82         , _osc_server (0)
83         , _osc_unix_server (0)
84         , _namespace_root ("/ardour")
85         , _send_route_changes (true)
86         , _debugmode (Off)
87         , gui (0)
88 {
89         _instance = this;
90
91         session_loaded (s);
92         session->Exported.connect (*this, MISSING_INVALIDATOR, boost::bind (&OSC::session_exported, this, _1, _2), this);
93 }
94
95 OSC::~OSC()
96 {
97         stop ();
98         _instance = 0;
99 }
100
101 void*
102 OSC::request_factory (uint32_t num_requests)
103 {
104         /* AbstractUI<T>::request_buffer_factory() is a template method only
105            instantiated in this source module. To provide something visible for
106            use in the interface/descriptor, we have this static method that is
107            template-free.
108         */
109         return request_buffer_factory (num_requests);
110 }
111
112 void
113 OSC::do_request (OSCUIRequest* req)
114 {
115         if (req->type == CallSlot) {
116
117                 call_slot (MISSING_INVALIDATOR, req->the_slot);
118
119         } else if (req->type == Quit) {
120
121                 stop ();
122         }
123 }
124
125 int
126 OSC::set_active (bool yn)
127 {
128         if (yn != active()) {
129
130                 if (yn) {
131                         if (start ()) {
132                                 return -1;
133                         }
134                 } else {
135                         if (stop ()) {
136                                 return -1;
137                         }
138                 }
139
140         }
141
142         return ControlProtocol::set_active (yn);
143 }
144
145 bool
146 OSC::get_active () const
147 {
148         return _osc_server != 0;
149 }
150
151 int
152 OSC::set_feedback (bool yn)
153 {
154         _send_route_changes = yn;
155         return 0;
156 }
157
158 bool
159 OSC::get_feedback () const
160 {
161         return _send_route_changes;
162 }
163
164 int
165 OSC::start ()
166 {
167         char tmpstr[255];
168
169         if (_osc_server) {
170                 /* already started */
171                 return 0;
172         }
173
174         for (int j=0; j < 20; ++j) {
175                 snprintf(tmpstr, sizeof(tmpstr), "%d", _port);
176
177                 //if ((_osc_server = lo_server_new_with_proto (tmpstr, LO_TCP, error_callback))) {
178                 //      break;
179                 //}
180
181                 if ((_osc_server = lo_server_new (tmpstr, error_callback))) {
182                         break;
183                 }
184
185 #ifdef DEBUG
186                 cerr << "can't get osc at port: " << _port << endl;
187 #endif
188                 _port++;
189                 continue;
190         }
191
192         if (!_osc_server) {
193                 return 1;
194         }
195
196 #ifdef ARDOUR_OSC_UNIX_SERVER
197
198         // APPEARS sluggish for now
199
200         // attempt to create unix socket server too
201
202         snprintf(tmpstr, sizeof(tmpstr), "/tmp/sooperlooper_XXXXXX");
203         int fd = mkstemp(tmpstr);
204
205         if (fd >= 0 ) {
206                 ::g_unlink (tmpstr);
207                 close (fd);
208
209                 _osc_unix_server = lo_server_new (tmpstr, error_callback);
210
211                 if (_osc_unix_server) {
212                         _osc_unix_socket_path = tmpstr;
213                 }
214         }
215 #endif
216
217         PBD::info << "OSC @ " << get_server_url () << endmsg;
218
219         std::string url_file;
220
221         if (find_file (ardour_config_search_path(), "osc_url", url_file)) {
222                 _osc_url_file = url_file;
223                 if (g_file_set_contents (_osc_url_file.c_str(), get_server_url().c_str(), -1, NULL)) {
224                         cerr << "Couldn't write '" <<  _osc_url_file << "'" <<endl;
225                 }
226         }
227
228         register_callbacks();
229
230         // lo_server_thread_add_method(_sthread, NULL, NULL, OSC::_dummy_handler, this);
231
232         /* startup the event loop thread */
233
234         BaseUI::run ();
235
236         return 0;
237 }
238
239 void
240 OSC::thread_init ()
241 {
242         pthread_set_name (event_loop_name().c_str());
243
244         if (_osc_unix_server) {
245                 Glib::RefPtr<IOSource> src = IOSource::create (lo_server_get_socket_fd (_osc_unix_server), IO_IN|IO_HUP|IO_ERR);
246                 src->connect (sigc::bind (sigc::mem_fun (*this, &OSC::osc_input_handler), _osc_unix_server));
247                 src->attach (_main_loop->get_context());
248                 local_server = src->gobj();
249                 g_source_ref (local_server);
250         }
251
252         if (_osc_server) {
253                 Glib::RefPtr<IOSource> src  = IOSource::create (lo_server_get_socket_fd (_osc_server), IO_IN|IO_HUP|IO_ERR);
254                 src->connect (sigc::bind (sigc::mem_fun (*this, &OSC::osc_input_handler), _osc_server));
255                 src->attach (_main_loop->get_context());
256                 remote_server = src->gobj();
257                 g_source_ref (remote_server);
258         }
259
260         PBD::notify_event_loops_about_thread_creation (pthread_self(), event_loop_name(), 2048);
261         SessionEvent::create_per_thread_pool (event_loop_name(), 128);
262 }
263
264 int
265 OSC::stop ()
266 {
267         /* stop main loop */
268
269         if (local_server) {
270                 g_source_destroy (local_server);
271                 g_source_unref (local_server);
272                 local_server = 0;
273         }
274
275         if (remote_server) {
276                 g_source_destroy (remote_server);
277                 g_source_unref (remote_server);
278                 remote_server = 0;
279         }
280
281         BaseUI::quit ();
282
283         if (_osc_server) {
284                 lo_server_free (_osc_server);
285                 _osc_server = 0;
286         }
287
288         if (_osc_unix_server) {
289                 lo_server_free (_osc_unix_server);
290                 _osc_unix_server = 0;
291         }
292
293         if (!_osc_unix_socket_path.empty()) {
294                 ::g_unlink (_osc_unix_socket_path.c_str());
295         }
296
297         if (!_osc_url_file.empty() ) {
298                 ::g_unlink (_osc_url_file.c_str() );
299         }
300
301         // Delete any active route observers
302         for (RouteObservers::iterator x = route_observers.begin(); x != route_observers.end();) {
303
304                 OSCRouteObserver* rc;
305
306                 if ((rc = dynamic_cast<OSCRouteObserver*>(*x)) != 0) {
307                         delete *x;
308                         x = route_observers.erase (x);
309                 } else {
310                         ++x;
311                 }
312         }
313
314         return 0;
315 }
316
317 void
318 OSC::register_callbacks()
319 {
320         lo_server srvs[2];
321         lo_server serv;
322
323         srvs[0] = _osc_server;
324         srvs[1] = _osc_unix_server;
325
326         for (size_t i = 0; i < 2; ++i) {
327
328                 if (!srvs[i]) {
329                         continue;
330                 }
331
332                 serv = srvs[i];
333
334
335 #define REGISTER_CALLBACK(serv,path,types, function) lo_server_add_method (serv, path, types, OSC::_ ## function, this)
336
337                 REGISTER_CALLBACK (serv, "/routes/list", "", routes_list);
338                 REGISTER_CALLBACK (serv, "/ardour/add_marker", "", add_marker);
339                 REGISTER_CALLBACK (serv, "/ardour/access_action", "s", access_action);
340                 REGISTER_CALLBACK (serv, "/ardour/loop_toggle", "", loop_toggle);
341                 REGISTER_CALLBACK (serv, "/ardour/loop_location", "ii", loop_location);
342                 REGISTER_CALLBACK (serv, "/ardour/goto_start", "", goto_start);
343                 REGISTER_CALLBACK (serv, "/ardour/goto_end", "", goto_end);
344                 REGISTER_CALLBACK (serv, "/ardour/rewind", "", rewind);
345                 REGISTER_CALLBACK (serv, "/ardour/ffwd", "", ffwd);
346                 REGISTER_CALLBACK (serv, "/ardour/transport_stop", "", transport_stop);
347                 REGISTER_CALLBACK (serv, "/ardour/transport_play", "", transport_play);
348                 REGISTER_CALLBACK (serv, "/ardour/transport_frame", "", transport_frame);
349                 REGISTER_CALLBACK (serv, "/ardour/transport_speed", "", transport_speed);
350                 REGISTER_CALLBACK (serv, "/ardour/record_enabled", "", record_enabled);
351                 REGISTER_CALLBACK (serv, "/ardour/set_transport_speed", "f", set_transport_speed);
352                 REGISTER_CALLBACK (serv, "/ardour/locate", "ii", locate);
353                 REGISTER_CALLBACK (serv, "/ardour/save_state", "", save_state);
354                 REGISTER_CALLBACK (serv, "/ardour/prev_marker", "", prev_marker);
355                 REGISTER_CALLBACK (serv, "/ardour/next_marker", "", next_marker);
356                 REGISTER_CALLBACK (serv, "/ardour/undo", "", undo);
357                 REGISTER_CALLBACK (serv, "/ardour/redo", "", redo);
358                 REGISTER_CALLBACK (serv, "/ardour/toggle_punch_in", "", toggle_punch_in);
359                 REGISTER_CALLBACK (serv, "/ardour/toggle_punch_out", "", toggle_punch_out);
360                 REGISTER_CALLBACK (serv, "/ardour/rec_enable_toggle", "", rec_enable_toggle);
361                 REGISTER_CALLBACK (serv, "/ardour/toggle_all_rec_enables", "", toggle_all_rec_enables);
362                 REGISTER_CALLBACK (serv, "/ardour/remove_marker", "", remove_marker_at_playhead);
363                 REGISTER_CALLBACK (serv, "/ardour/jump_bars", "f", jump_by_bars);
364                 REGISTER_CALLBACK (serv, "/ardour/jump_seconds", "f", jump_by_seconds);
365                 REGISTER_CALLBACK (serv, "/ardour/mark_in", "", mark_in);
366                 REGISTER_CALLBACK (serv, "/ardour/mark_out", "", mark_out);
367                 REGISTER_CALLBACK (serv, "/ardour/toggle_click", "", toggle_click);
368                 REGISTER_CALLBACK (serv, "/ardour/midi_panic", "", midi_panic);
369                 REGISTER_CALLBACK (serv, "/ardour/toggle_roll", "", toggle_roll);
370                 REGISTER_CALLBACK (serv, "/ardour/stop_forget", "", stop_forget);
371                 REGISTER_CALLBACK (serv, "/ardour/set_punch_range", "", set_punch_range);
372                 REGISTER_CALLBACK (serv, "/ardour/set_loop_range", "", set_loop_range);
373                 REGISTER_CALLBACK (serv, "/ardour/set_session_range", "", set_session_range);
374                 REGISTER_CALLBACK (serv, "/ardour/toggle_monitor_mute", "", toggle_monitor_mute);
375                 REGISTER_CALLBACK (serv, "/ardour/toggle_monitor_dim", "", toggle_monitor_dim);
376                 REGISTER_CALLBACK (serv, "/ardour/toggle_monitor_mono", "", toggle_monitor_mono);
377                 REGISTER_CALLBACK (serv, "/ardour/quick_snapshot_switch", "", quick_snapshot_switch);
378                 REGISTER_CALLBACK (serv, "/ardour/quick_snapshot_stay", "", quick_snapshot_stay);
379                 REGISTER_CALLBACK (serv, "/ardour/fit_1_track", "", fit_1_track);
380                 REGISTER_CALLBACK (serv, "/ardour/fit_2_tracks", "", fit_2_tracks);
381                 REGISTER_CALLBACK (serv, "/ardour/fit_4_tracks", "", fit_4_tracks);
382                 REGISTER_CALLBACK (serv, "/ardour/fit_8_tracks", "", fit_8_tracks);
383                 REGISTER_CALLBACK (serv, "/ardour/fit_16_tracks", "", fit_16_tracks);
384                 REGISTER_CALLBACK (serv, "/ardour/fit_32_tracks", "", fit_32_tracks);
385                 REGISTER_CALLBACK (serv, "/ardour/fit_all_tracks", "", fit_all_tracks);
386                 REGISTER_CALLBACK (serv, "/ardour/zoom_100_ms", "", zoom_100_ms);
387                 REGISTER_CALLBACK (serv, "/ardour/zoom_1_sec", "", zoom_1_sec);
388                 REGISTER_CALLBACK (serv, "/ardour/zoom_1_min", "", zoom_1_min);
389                 REGISTER_CALLBACK (serv, "/ardour/zoom_5_min", "", zoom_5_min);
390                 REGISTER_CALLBACK (serv, "/ardour/zoom_10_min", "", zoom_10_min);
391                 REGISTER_CALLBACK (serv, "/ardour/zoom_to_session", "", zoom_to_session);
392
393
394                 /*
395                  * NOTE: these messages are provided for (arguably broken) apps
396                  *   that MUST send float args ( TouchOSC and Lemur ).
397                  * Normally these ardour transport messages don't require an argument,
398                  * so we're providing redundant calls with vestigial "float" args.
399                  *
400                  * These controls are active on 1.0 only (to prevent duplicate action on
401                  * press "/button 1", and release "/button 0")
402                  * http://hexler.net/docs/touchosc-controls-reference
403                  */
404                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/loop_toggle", "f", loop_toggle);
405                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/add_marker", "f", add_marker);
406                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/goto_start", "f", goto_start);
407                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/goto_end", "f", goto_end);
408                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/rewind", "f", rewind);
409                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/ffwd", "f", ffwd);
410                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/transport_stop", "f", transport_stop);
411                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/transport_play", "f", transport_play);
412                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/save_state", "f", save_state);
413                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/prev_marker", "f", prev_marker);
414                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/next_marker", "f", next_marker);
415                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/undo", "f", undo);
416                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/redo", "f", redo);
417                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_punch_in", "f", toggle_punch_in);
418                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_punch_out", "f", toggle_punch_out);
419                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/rec_enable_toggle", "f", rec_enable_toggle);
420                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_all_rec_enables", "f", toggle_all_rec_enables);
421                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/remove_marker", "f", remove_marker_at_playhead);
422                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/mark_in", "f", mark_in);
423                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/mark_out", "f", mark_out);
424                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_click", "f", toggle_click);
425                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/midi_panic", "f", midi_panic);
426                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_roll", "f", toggle_roll);
427                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/stop_forget", "f", stop_forget);
428                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/set_punch_range", "f", set_punch_range);
429                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/set_loop_range", "f", set_loop_range);
430                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/set_session_range", "f", set_session_range);
431                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_monitor_mute", "f", toggle_monitor_mute);
432                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_monitor_dim", "f", toggle_monitor_dim);
433                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/toggle_monitor_mono", "f", toggle_monitor_mono);
434                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/quick_snapshot_switch", "f", quick_snapshot_switch);
435                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/quick_snapshot_stay", "f", quick_snapshot_stay);
436                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/fit_1_track", "f", fit_1_track);
437                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/fit_2_tracks", "f", fit_2_tracks);
438                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/fit_4_tracks", "f", fit_4_tracks);
439                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/fit_8_tracks", "f", fit_8_tracks);
440                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/fit_16_tracks", "f", fit_16_tracks);
441                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/fit_32_tracks", "f", fit_32_tracks);
442                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/fit_all_tracks", "f", fit_all_tracks);
443                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/zoom_100_ms", "f", zoom_100_ms);
444                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/zoom_1_sec", "f", zoom_1_sec);
445                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/zoom_1_min", "f", zoom_1_min);
446                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/zoom_5_min", "f", zoom_5_min);
447                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/zoom_10_min", "f", zoom_10_min);
448                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/zoom_to_session", "f", zoom_to_session);
449                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/scroll_up_1_track", "f", scroll_up_1_track);
450                 REGISTER_CALLBACK (serv, "/ardour/pushbutton/scroll_dn_1_track", "f", scroll_dn_1_track);
451
452                 /* These commands require the route index in addition to the arg; TouchOSC (et al) can't use these  */ 
453                 REGISTER_CALLBACK (serv, "/ardour/routes/mute", "ii", route_mute);
454                 REGISTER_CALLBACK (serv, "/ardour/routes/solo", "ii", route_solo);
455                 REGISTER_CALLBACK (serv, "/ardour/routes/recenable", "ii", route_recenable);
456                 REGISTER_CALLBACK (serv, "/ardour/routes/gainabs", "if", route_set_gain_abs);
457                 REGISTER_CALLBACK (serv, "/ardour/routes/gaindB", "if", route_set_gain_dB);
458                 REGISTER_CALLBACK (serv, "/ardour/routes/trimabs", "if", route_set_trim_abs);
459                 REGISTER_CALLBACK (serv, "/ardour/routes/trimdB", "if", route_set_trim_dB);
460                 REGISTER_CALLBACK (serv, "/ardour/routes/pan_stereo_position", "if", route_set_pan_stereo_position);
461                 REGISTER_CALLBACK (serv, "/ardour/routes/pan_stereo_width", "if", route_set_pan_stereo_width);
462                 REGISTER_CALLBACK (serv, "/ardour/routes/plugin/parameter", "iiif", route_plugin_parameter);
463                 REGISTER_CALLBACK (serv, "/ardour/routes/plugin/parameter/print", "iii", route_plugin_parameter_print);
464                 REGISTER_CALLBACK (serv, "/ardour/routes/send/gainabs", "iif", route_set_send_gain_abs);
465                 REGISTER_CALLBACK (serv, "/ardour/routes/send/gaindB", "iif", route_set_send_gain_dB);
466
467                 /* still not-really-standardized query interface */
468                 //REGISTER_CALLBACK (serv, "/ardour/*/#current_value", "", current_value);
469                 //REGISTER_CALLBACK (serv, "/ardour/set", "", set);
470
471                 // un/register_update args= s:ctrl s:returl s:retpath
472                 //lo_server_add_method(serv, "/register_update", "sss", OSC::global_register_update_handler, this);
473                 //lo_server_add_method(serv, "/unregister_update", "sss", OSC::global_unregister_update_handler, this);
474                 //lo_server_add_method(serv, "/register_auto_update", "siss", OSC::global_register_auto_update_handler, this);
475                 //lo_server_add_method(serv, "/unregister_auto_update", "sss", OSC::_global_unregister_auto_update_handler, this);
476
477                 /* this is a special catchall handler,
478                  * register at the end so this is only called if no
479                  * other handler matches (used for debug) */
480                 lo_server_add_method (serv, 0, 0, _catchall, this);
481         }
482 }
483
484 bool
485 OSC::osc_input_handler (IOCondition ioc, lo_server srv)
486 {
487         if (ioc & ~IO_IN) {
488                 return false;
489         }
490
491         if (ioc & IO_IN) {
492                 lo_server_recv (srv);
493         }
494
495         return true;
496 }
497
498 std::string
499 OSC::get_server_url()
500 {
501         string url;
502         char * urlstr;
503
504         if (_osc_server) {
505                 urlstr = lo_server_get_url (_osc_server);
506                 url = urlstr;
507                 free (urlstr);
508         }
509
510         return url;
511 }
512
513 std::string
514 OSC::get_unix_server_url()
515 {
516         string url;
517         char * urlstr;
518
519         if (_osc_unix_server) {
520                 urlstr = lo_server_get_url (_osc_unix_server);
521                 url = urlstr;
522                 free (urlstr);
523         }
524
525         return url;
526 }
527
528 void
529 OSC::listen_to_route (boost::shared_ptr<Route> route, lo_address addr)
530 {
531         /* avoid duplicate listens */
532
533         for (RouteObservers::iterator x = route_observers.begin(); x != route_observers.end(); ++x) {
534
535                 OSCRouteObserver* ro;
536
537                 if ((ro = dynamic_cast<OSCRouteObserver*>(*x)) != 0) {
538
539                         int res = strcmp(lo_address_get_hostname(ro->address()), lo_address_get_hostname(addr));
540
541                         if (ro->route() == route && res == 0) {
542                                 return;
543                         }
544                 }
545         }
546
547         OSCRouteObserver* o = new OSCRouteObserver (route, addr);
548         route_observers.push_back (o);
549
550         route->DropReferences.connect (*this, MISSING_INVALIDATOR, boost::bind (&OSC::drop_route, this, boost::weak_ptr<Route> (route)), this);
551 }
552
553 void
554 OSC::drop_route (boost::weak_ptr<Route> wr)
555 {
556         boost::shared_ptr<Route> r = wr.lock ();
557
558         if (!r) {
559                 return;
560         }
561
562         for (RouteObservers::iterator x = route_observers.begin(); x != route_observers.end();) {
563
564                 OSCRouteObserver* rc;
565
566                 if ((rc = dynamic_cast<OSCRouteObserver*>(*x)) != 0) {
567
568                         if (rc->route() == r) {
569                                 delete *x;
570                                 x = route_observers.erase (x);
571                         } else {
572                                 ++x;
573                         }
574                 } else {
575                         ++x;
576                 }
577         }
578 }
579
580 void
581 OSC::end_listen (boost::shared_ptr<Route> r, lo_address addr)
582 {
583         RouteObservers::iterator x;
584
585         // Remove the route observers
586         for (x = route_observers.begin(); x != route_observers.end();) {
587
588                 OSCRouteObserver* ro;
589
590                 if ((ro = dynamic_cast<OSCRouteObserver*>(*x)) != 0) {
591
592                         int res = strcmp(lo_address_get_hostname(ro->address()), lo_address_get_hostname(addr));
593
594                         if (ro->route() == r && res == 0) {
595                                 delete *x;
596                                 x = route_observers.erase (x);
597                         }
598                         else {
599                                 ++x;
600                         }
601                 }
602                 else {
603                         ++x;
604                 }
605         }
606 }
607
608 void
609 OSC::current_value_query (const char* path, size_t len, lo_arg **argv, int argc, lo_message msg)
610 {
611         char* subpath;
612
613         subpath = (char*) malloc (len-15+1);
614         memcpy (subpath, path, len-15);
615         subpath[len-15] = '\0';
616
617         send_current_value (subpath, argv, argc, msg);
618
619         free (subpath);
620 }
621
622 void
623 OSC::send_current_value (const char* path, lo_arg** argv, int argc, lo_message msg)
624 {
625         if (!session) {
626                 return;
627         }
628
629         lo_message reply = lo_message_new ();
630         boost::shared_ptr<Route> r;
631         int id;
632
633         lo_message_add_string (reply, path);
634
635         if (argc == 0) {
636                 lo_message_add_string (reply, "bad syntax");
637         } else {
638                 id = argv[0]->i;
639                 r = session->route_by_remote_id (id);
640
641                 if (!r) {
642                         lo_message_add_string (reply, "not found");
643                 } else {
644
645                         if (strcmp (path, "/routes/state") == 0) {
646
647                                 if (boost::dynamic_pointer_cast<AudioTrack>(r)) {
648                                         lo_message_add_string (reply, "AT");
649                                 } else if (boost::dynamic_pointer_cast<MidiTrack>(r)) {
650                                         lo_message_add_string (reply, "MT");
651                                 } else {
652                                         lo_message_add_string (reply, "B");
653                                 }
654
655                                 lo_message_add_string (reply, r->name().c_str());
656                                 lo_message_add_int32 (reply, r->n_inputs().n_audio());
657                                 lo_message_add_int32 (reply, r->n_outputs().n_audio());
658                                 lo_message_add_int32 (reply, r->muted());
659                                 lo_message_add_int32 (reply, r->soloed());
660
661                         } else if (strcmp (path, "/routes/mute") == 0) {
662
663                                 lo_message_add_int32 (reply, (float) r->muted());
664
665                         } else if (strcmp (path, "/routes/solo") == 0) {
666
667                                 lo_message_add_int32 (reply, r->soloed());
668                         }
669                 }
670         }
671
672         lo_send_message (lo_message_get_source (msg), "#reply", reply);
673         lo_message_free (reply);
674 }
675
676 int
677 OSC::_catchall (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data)
678 {
679         return ((OSC*)user_data)->catchall (path, types, argv, argc, data);
680 }
681
682 int
683 OSC::catchall (const char *path, const char* types, lo_arg **argv, int argc, lo_message msg)
684 {
685         size_t len;
686         int ret = 1; /* unhandled */
687
688         //cerr << "Received a message, path = " << path << " types = \""
689         //     << (types ? types : "NULL") << '"' << endl;
690
691         /* 15 for /#current_value plus 2 for /<path> */
692
693         len = strlen (path);
694
695         if (len >= 17 && !strcmp (&path[len-15], "/#current_value")) {
696                 current_value_query (path, len, argv, argc, msg);
697                 ret = 0;
698
699         } else if (strcmp (path, "/routes/listen") == 0) {
700
701                 cerr << "set up listener\n";
702
703                 lo_message reply = lo_message_new ();
704
705                 if (argc <= 0) {
706                         lo_message_add_string (reply, "syntax error");
707                 } else {
708                         for (int n = 0; n < argc; ++n) {
709
710                                 boost::shared_ptr<Route> r = session->route_by_remote_id (argv[n]->i);
711
712                                 if (!r) {
713                                         lo_message_add_string (reply, "not found");
714                                         cerr << "no such route\n";
715                                         break;
716                                 } else {
717                                         cerr << "add listener\n";
718                                         listen_to_route (r, lo_message_get_source (msg));
719                                         lo_message_add_int32 (reply, argv[n]->i);
720                                 }
721                         }
722                 }
723
724                 lo_send_message (lo_message_get_source (msg), "#reply", reply);
725                 lo_message_free (reply);
726
727                 ret = 0;
728
729         } else if (strcmp (path, "/routes/ignore") == 0) {
730
731                 for (int n = 0; n < argc; ++n) {
732
733                         boost::shared_ptr<Route> r = session->route_by_remote_id (argv[n]->i);
734
735                         if (r) {
736                                 end_listen (r, lo_message_get_source (msg));
737                         }
738                 }
739
740                 ret = 0;
741         } else if (argc == 1 && types[0] == 'f') { // single float -- probably TouchOSC
742                 if (!strncmp (path, "/ardour/routes/gainabs/", 23) && strlen (path) > 23) {
743                         int rid = atoi (&path[23]);
744                         // use some power-scale mapping??
745                         route_set_gain_abs (rid, argv[0]->f);
746                         ret = 0;
747                 }
748                 else if (!strncmp (path, "/ardour/routes/trimabs/", 23) && strlen (path) > 23) {
749                         int rid = atoi (&path[23]);
750                         // normalize 0..1 ?
751                         route_set_trim_abs (rid, argv[0]->f);
752                         ret = 0;
753                 }
754                 else if (!strncmp (path, "/ardour/routes/mute/", 20) && strlen (path) > 20) {
755                         int rid = atoi (&path[20]);
756                         route_mute (rid, argv[0]->f == 1.0);
757                         ret = 0;
758                 }
759                 else if (!strncmp (path, "/ardour/routes/solo/", 20) && strlen (path) > 20) {
760                         int rid = atoi (&path[20]);
761                         route_solo (rid, argv[0]->f == 1.0);
762                         ret = 0;
763                 }
764                 else if (!strncmp (path, "/ardour/routes/recenable/", 25) && strlen (path) > 25) {
765                         int rid = atoi (&path[25]);
766                         route_recenable (rid, argv[0]->f == 1.0);
767                         ret = 0;
768                 }
769         }
770
771         if ((ret && _debugmode == Unhandled)) {
772                 debugmsg (_("Unhandled OSC message"), path, types, argv, argc);
773         }
774
775         return ret;
776 }
777
778 void
779 OSC::debugmsg (const char *prefix, const char *path, const char* types, lo_arg **argv, int argc)
780 {
781         std::stringstream ss;
782         for (int i = 0; i < argc; ++i) {
783                 lo_type type = (lo_type)types[i];
784                         ss << " ";
785                 switch (type) {
786                         case LO_INT32:
787                                 ss << "i:" << argv[i]->i;
788                                 break;
789                         case LO_FLOAT:
790                                 ss << "f:" << argv[i]->f;
791                                 break;
792                         case LO_DOUBLE:
793                                 ss << "d:" << argv[i]->d;
794                                 break;
795                         case LO_STRING:
796                                 ss << "s:" << &argv[i]->s;
797                                 break;
798                         case LO_INT64:
799                                 ss << "h:" << argv[i]->h;
800                                 break;
801                         case LO_CHAR:
802                                 ss << "c:" << argv[i]->s;
803                                 break;
804                         case LO_TIMETAG:
805                                 ss << "<Timetag>";
806                                 break;
807                         case LO_BLOB:
808                                 ss << "<BLOB>";
809                                 break;
810                         case LO_TRUE:
811                                 ss << "#T";
812                                 break;
813                         case LO_FALSE:
814                                 ss << "#F";
815                                 break;
816                         case LO_NIL:
817                                 ss << "NIL";
818                                 break;
819                         case LO_INFINITUM:
820                                 ss << "#inf";
821                                 break;
822                         case LO_MIDI:
823                                 ss << "<MIDI>";
824                                 break;
825                         case LO_SYMBOL:
826                                 ss << "<SYMBOL>";
827                                 break;
828                         default:
829                                 ss << "< ?? >";
830                                 break;
831                 }
832         }
833         PBD::info << prefix << ": " << path << ss.str() << endmsg;
834 }
835
836 void
837 OSC::update_clock ()
838 {
839
840 }
841
842 // "Application Hook" Handlers //
843 void
844 OSC::session_loaded (Session& s)
845 {
846         lo_address listener = lo_address_new (NULL, "7770");
847         lo_send (listener, "/session/loaded", "ss", s.path().c_str(), s.name().c_str());
848 }
849
850 void
851 OSC::session_exported (std::string path, std::string name)
852 {
853         lo_address listener = lo_address_new (NULL, "7770");
854         lo_send (listener, "/session/exported", "ss", path.c_str(), name.c_str());
855 }
856
857 // end "Application Hook" Handlers //
858
859 /* path callbacks */
860
861 int
862 OSC::current_value (const char */*path*/, const char */*types*/, lo_arg **/*argv*/, int /*argc*/, void */*data*/, void* /*user_data*/)
863 {
864 #if 0
865         const char* returl;
866
867         if (argc < 3 || types == 0 || strlen (types) < 3 || types[0] != 's' || types[1] != 's' || types[2] != s) {
868                 return 1;
869         }
870
871         const char *returl = argv[1]->s;
872         lo_address addr = find_or_cache_addr (returl);
873
874         const char *retpath = argv[2]->s;
875
876
877         if (strcmp (argv[0]->s, "transport_frame") == 0) {
878
879                 if (session) {
880                         lo_send (addr, retpath, "i", session->transport_frame());
881                 }
882
883         } else if (strcmp (argv[0]->s, "transport_speed") == 0) {
884
885                 if (session) {
886                         lo_send (addr, retpath, "i", session->transport_frame());
887                 }
888
889         } else if (strcmp (argv[0]->s, "transport_locked") == 0) {
890
891                 if (session) {
892                         lo_send (addr, retpath, "i", session->transport_frame());
893                 }
894
895         } else if (strcmp (argv[0]->s, "punch_in") == 0) {
896
897                 if (session) {
898                         lo_send (addr, retpath, "i", session->transport_frame());
899                 }
900
901         } else if (strcmp (argv[0]->s, "punch_out") == 0) {
902
903                 if (session) {
904                         lo_send (addr, retpath, "i", session->transport_frame());
905                 }
906
907         } else if (strcmp (argv[0]->s, "rec_enable") == 0) {
908
909                 if (session) {
910                         lo_send (addr, retpath, "i", session->transport_frame());
911                 }
912
913         } else {
914
915                 /* error */
916         }
917 #endif
918         return 0;
919 }
920
921 void
922 OSC::routes_list (lo_message msg)
923 {
924         if (!session) {
925                 return;
926         }
927         for (int n = 0; n < (int) session->nroutes(); ++n) {
928
929                 boost::shared_ptr<Route> r = session->route_by_remote_id (n);
930
931                 if (r) {
932
933                         lo_message reply = lo_message_new ();
934
935                         if (boost::dynamic_pointer_cast<AudioTrack>(r)) {
936                                 lo_message_add_string (reply, "AT");
937                         } else if (boost::dynamic_pointer_cast<MidiTrack>(r)) {
938                                 lo_message_add_string (reply, "MT");
939                         } else {
940                                 lo_message_add_string (reply, "B");
941                         }
942
943                         lo_message_add_string (reply, r->name().c_str());
944                         lo_message_add_int32 (reply, r->n_inputs().n_audio());
945                         lo_message_add_int32 (reply, r->n_outputs().n_audio());
946                         lo_message_add_int32 (reply, r->muted());
947                         lo_message_add_int32 (reply, r->soloed());
948                         lo_message_add_int32 (reply, r->remote_control_id());
949
950                         if (boost::dynamic_pointer_cast<AudioTrack>(r)
951                                         || boost::dynamic_pointer_cast<MidiTrack>(r)) {
952
953                                 boost::shared_ptr<Track> t = boost::dynamic_pointer_cast<Track>(r);
954                                 lo_message_add_int32 (reply, t->record_enabled());
955                         }
956
957                         //Automatically listen to routes listed
958                         listen_to_route(r, lo_message_get_source (msg));
959
960                         lo_send_message (lo_message_get_source (msg), "#reply", reply);
961                         lo_message_free (reply);
962                 }
963         }
964
965         // Send end of listing message
966         lo_message reply = lo_message_new ();
967
968         lo_message_add_string (reply, "end_route_list");
969         lo_message_add_int64 (reply, session->frame_rate());
970         lo_message_add_int64 (reply, session->current_end_frame());
971
972         lo_send_message (lo_message_get_source (msg), "#reply", reply);
973
974         lo_message_free (reply);
975 }
976
977 void
978 OSC::transport_frame (lo_message msg)
979 {
980         if (!session) {
981                 return;
982         }
983         framepos_t pos = session->transport_frame ();
984
985         lo_message reply = lo_message_new ();
986         lo_message_add_int64 (reply, pos);
987
988         lo_send_message (lo_message_get_source (msg), "/ardour/transport_frame", reply);
989
990         lo_message_free (reply);
991 }
992
993 void
994 OSC::transport_speed (lo_message msg)
995 {
996         if (!session) {
997                 return;
998         }
999         double ts = session->transport_speed ();
1000
1001         lo_message reply = lo_message_new ();
1002         lo_message_add_double (reply, ts);
1003
1004         lo_send_message (lo_message_get_source (msg), "/ardour/transport_speed", reply);
1005
1006         lo_message_free (reply);
1007 }
1008
1009 void
1010 OSC::record_enabled (lo_message msg)
1011 {
1012         if (!session) {
1013                 return;
1014         }
1015         int re = (int)session->get_record_enabled ();
1016
1017         lo_message reply = lo_message_new ();
1018         lo_message_add_int32 (reply, re);
1019
1020         lo_send_message (lo_message_get_source (msg), "/ardour/record_enabled", reply);
1021
1022         lo_message_free (reply);
1023 }
1024
1025
1026 int
1027 OSC::route_mute (int rid, int yn)
1028 {
1029         if (!session) return -1;
1030
1031         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1032
1033         if (r) {
1034                 r->set_mute (yn, this);
1035         }
1036
1037         return 0;
1038 }
1039
1040 int
1041 OSC::route_solo (int rid, int yn)
1042 {
1043         if (!session) return -1;
1044
1045         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1046
1047         if (r) {
1048                 boost::shared_ptr<RouteList> rl (new RouteList);
1049                 rl->push_back (r);
1050                 session->set_solo (rl, yn);
1051         }
1052
1053         return 0;
1054 }
1055
1056 int
1057 OSC::route_recenable (int rid, int yn)
1058 {
1059         if (!session) return -1;
1060
1061         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1062
1063         if (r) {
1064                 r->set_record_enabled (yn, this);
1065         }
1066
1067         return 0;
1068 }
1069
1070 int
1071 OSC::route_set_gain_abs (int rid, float level)
1072 {
1073         if (!session) return -1;
1074
1075         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1076
1077         if (r) {
1078                 r->set_gain (level, PBD::Controllable::NoGroup);
1079         }
1080
1081         return 0;
1082 }
1083
1084 int
1085 OSC::route_set_gain_dB (int rid, float dB)
1086 {
1087         return route_set_gain_abs (rid, dB_to_coefficient (dB));
1088 }
1089
1090
1091 int
1092 OSC::route_set_trim_abs (int rid, float level)
1093 {
1094         if (!session) return -1;
1095
1096         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1097
1098         if (r) {
1099                 r->set_trim (level, this);
1100         }
1101
1102         return 0;
1103 }
1104
1105 int
1106 OSC::route_set_trim_dB (int rid, float dB)
1107 {
1108         return route_set_trim_abs(rid, dB_to_coefficient (dB));
1109 }
1110
1111
1112 int
1113 OSC::route_set_pan_stereo_position (int rid, float pos)
1114 {
1115         if (!session) return -1;
1116
1117         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1118
1119         if (r) {
1120                 boost::shared_ptr<Panner> panner = r->panner();
1121                 if (panner) {
1122                         panner->set_position (pos);
1123                 }
1124         }
1125
1126         return 0;
1127
1128 }
1129
1130 int
1131 OSC::route_set_pan_stereo_width (int rid, float pos)
1132 {
1133         if (!session) return -1;
1134
1135         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1136
1137         if (r) {
1138                 boost::shared_ptr<Panner> panner = r->panner();
1139                 if (panner) {
1140                         panner->set_width (pos);
1141                 }
1142         }
1143
1144         return 0;
1145
1146 }
1147
1148 int
1149 OSC::route_set_send_gain_abs (int rid, int sid, float val)
1150 {
1151         if (!session) {
1152                 return -1;
1153         }
1154
1155         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1156
1157         if (!r) {
1158                 return -1;
1159         }
1160
1161         /* revert to zero-based counting */
1162
1163         if (sid > 0) {
1164                 --sid;
1165         }
1166
1167         boost::shared_ptr<Processor> p = r->nth_send (sid);
1168
1169         if (p) {
1170                 boost::shared_ptr<Send> s = boost::dynamic_pointer_cast<Send>(p);
1171                 boost::shared_ptr<Amp> a = s->amp();
1172
1173                 if (a) {
1174                         a->gain_control()->set_value (val, PBD::Controllable::NoGroup);
1175                 }
1176         }
1177         return 0;
1178 }
1179
1180 int
1181 OSC::route_set_send_gain_dB (int rid, int sid, float val)
1182 {
1183         if (!session) {
1184                 return -1;
1185         }
1186
1187         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1188
1189         if (!r) {
1190                 return -1;
1191         }
1192
1193         /* revert to zero-based counting */
1194
1195         if (sid > 0) {
1196                 --sid;
1197         }
1198
1199         boost::shared_ptr<Processor> p = r->nth_send (sid);
1200
1201         if (p) {
1202                 boost::shared_ptr<Send> s = boost::dynamic_pointer_cast<Send>(p);
1203                 boost::shared_ptr<Amp> a = s->amp();
1204
1205                 if (a) {
1206                         a->gain_control()->set_value (dB_to_coefficient (val), PBD::Controllable::NoGroup);
1207                 }
1208         }
1209         return 0;
1210 }
1211
1212 int
1213 OSC::route_plugin_parameter (int rid, int piid, int par, float val)
1214 {
1215         if (!session)
1216                 return -1;
1217
1218         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1219
1220         if (!r) {
1221                 PBD::error << "OSC: Invalid Remote Control ID '" << rid << "'" << endmsg;
1222                 return -1;
1223         }
1224
1225         boost::shared_ptr<Processor> redi=r->nth_plugin (piid);
1226
1227         if (!redi) {
1228                 PBD::error << "OSC: cannot find plugin # " << piid << " for RID '" << rid << "'" << endmsg;
1229                 return -1;
1230         }
1231
1232         boost::shared_ptr<PluginInsert> pi;
1233
1234         if (!(pi = boost::dynamic_pointer_cast<PluginInsert>(redi))) {
1235                 PBD::error << "OSC: given processor # " << piid << " on RID '" << rid << "' is not a Plugin." << endmsg;
1236                 return -1;
1237         }
1238
1239         boost::shared_ptr<ARDOUR::Plugin> pip = pi->plugin();
1240         bool ok=false;
1241
1242         uint32_t controlid = pip->nth_parameter (par,ok);
1243
1244         if (!ok) {
1245                 PBD::error << "OSC: Cannot find parameter # " << par <<  " for plugin # " << piid << " on RID '" << rid << "'" << endmsg;
1246                 return -1;
1247         }
1248
1249         if (!pip->parameter_is_input(controlid)) {
1250                 PBD::error << "OSC: Parameter # " << par <<  " for plugin # " << piid << " on RID '" << rid << "' is not a control input" << endmsg;
1251                 return -1;
1252         }
1253
1254         ParameterDescriptor pd;
1255         pi->plugin()->get_parameter_descriptor (controlid,pd);
1256
1257         if (val >= pd.lower && val < pd.upper) {
1258
1259                 boost::shared_ptr<AutomationControl> c = pi->automation_control (Evoral::Parameter(PluginAutomation, 0, controlid));
1260                 // cerr << "parameter:" << redi->describe_parameter(controlid) << " val:" << val << "\n";
1261                 c->set_value (val, PBD::Controllable::NoGroup);
1262         } else {
1263                 PBD::warning << "OSC: Parameter # " << par <<  " for plugin # " << piid << " on RID '" << rid << "' is out of range" << endmsg;
1264                 PBD::info << "OSC: Valid range min=" << pd.lower << " max=" << pd.upper << endmsg;
1265         }
1266
1267         return 0;
1268 }
1269
1270 int
1271 OSC::route_plugin_parameter_print (int rid, int piid, int par)
1272 {
1273         if (!session) {
1274                 return -1;
1275         }
1276
1277         boost::shared_ptr<Route> r = session->route_by_remote_id (rid);
1278
1279         if (!r) {
1280                 return -1;
1281         }
1282
1283         boost::shared_ptr<Processor> redi=r->nth_processor (piid);
1284
1285         if (!redi) {
1286                 return -1;
1287         }
1288
1289         boost::shared_ptr<PluginInsert> pi;
1290
1291         if (!(pi = boost::dynamic_pointer_cast<PluginInsert>(redi))) {
1292                 return -1;
1293         }
1294
1295         boost::shared_ptr<ARDOUR::Plugin> pip = pi->plugin();
1296         bool ok=false;
1297
1298         uint32_t controlid = pip->nth_parameter (par,ok);
1299
1300         if (!ok) {
1301                 return -1;
1302         }
1303
1304         ParameterDescriptor pd;
1305
1306         if (pi->plugin()->get_parameter_descriptor (controlid, pd) == 0) {
1307                 boost::shared_ptr<AutomationControl> c = pi->automation_control (Evoral::Parameter(PluginAutomation, 0, controlid));
1308
1309                 cerr << "parameter:     " << redi->describe_parameter(controlid)  << "\n";
1310                 cerr << "current value: " << c->get_value ();
1311                 cerr << "lower value:   " << pd.lower << "\n";
1312                 cerr << "upper value:   " << pd.upper << "\n";
1313         }
1314
1315         return 0;
1316 }
1317
1318 XMLNode&
1319 OSC::get_state ()
1320 {
1321         XMLNode& node (ControlProtocol::get_state());
1322         node.add_property("debugmode", (int) _debugmode); // TODO: enum2str
1323         return node;
1324 }
1325
1326 int
1327 OSC::set_state (const XMLNode& node, int version)
1328 {
1329         if (ControlProtocol::set_state (node, version)) {
1330                 return -1;
1331         }
1332         XMLProperty const * p = node.property (X_("debugmode"));
1333         if (p) {
1334                 _debugmode = OSCDebugMode (PBD::atoi(p->value ()));
1335         }
1336
1337         return 0;
1338 }