2 * Copyright (C) 2006-2009 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
30 #include <boost/shared_ptr.hpp>
34 #include <glibmm/main.h>
36 #define ABSTRACT_UI_EXPORTS
37 #include "pbd/abstract_ui.h"
39 #include "ardour/types.h"
40 #include "control_protocol/control_protocol.h"
44 class OSCControllable;
45 class OSCRouteObserver;
46 class OSCGlobalObserver;
47 class OSCSelectObserver;
54 /* this is mostly a placeholder because I suspect that at some
55 point we will want to add more members to accomodate
56 certain types of requests to the OSC UI
59 namespace ArdourSurface {
61 struct OSCUIRequest : public BaseUI::BaseRequestObject {
67 class OSC : public ARDOUR::ControlProtocol, public AbstractUI<OSCUIRequest>
70 OSC (ARDOUR::Session&, uint32_t port);
73 static OSC* instance() { return _instance; }
75 XMLNode& get_state ();
76 int set_state (const XMLNode&, int version);
78 bool has_editor () const { return true; }
79 void* get_gui () const;
80 void tear_down_gui ();
82 int set_active (bool yn);
83 bool get_active () const;
84 int set_feedback (bool yn);
85 bool get_feedback () const;
91 static void* request_factory (uint32_t);
99 typedef std::vector<boost::shared_ptr<ARDOUR::Stripable> > Sorted;
100 Sorted get_sorted_stripables(std::bitset<32> types);
102 // keep a surface's global setup by remote server url
105 std::string remote_url; // the url these setting belong to
106 uint32_t bank; // current bank
107 uint32_t bank_size; // size of banks for this surface
108 std::bitset<32> strip_types;// what strip types are a part of this bank
109 uint32_t nstrips; // how many strips are there for strip_types
110 std::bitset<32> feedback; // What is fed back? strips/meters/timecode/bar_beat/global
111 int gainmode; // what kind of faders do we have Gain db or position 0 to 1?
112 uint32_t expand; // Used by /select/select
113 bool expand_enable; // use expand instead of select
114 OSCSelectObserver* sel_obs; // So we can sync select feedback with selected channel
115 Sorted strips; // list of stripables for this surface
119 * [0] - Strips - buttons
120 * [1] - Strips - variables (pots/faders)
121 * [2] - Strips - Send SSID as path extension
122 * [3] - Send heart beat to surface
123 * [4] - Send feedback for master/global buttons/variables
124 * [5] - Send Bar and Beat
125 * [6] - Send Time code
126 * [7] - Send metering as dB or positional depending on gainmode
127 * [8] - Send metering as 16 bits (led strip)
128 * [9] - Send signal present (signal greater than -20dB)
129 * [10] - Send Playhead position as samples
130 * [11] - Send Playhead position as minutes seconds
131 * [12] - Send Playhead position like primary/secondary GUI clocks
135 // storage for each surface's settings
136 typedef std::vector<OSCSurface> Surface;
139 std::string get_server_url ();
140 void set_debug_mode (OSCDebugMode m) { _debugmode = m; }
141 OSCDebugMode get_debug_mode () { return _debugmode; }
145 void do_request (OSCUIRequest*);
147 GSource* local_server;
148 GSource* remote_server;
150 bool osc_input_handler (Glib::IOCondition, lo_server);
155 volatile bool _shutdown;
156 lo_server _osc_server;
157 lo_server _osc_unix_server;
158 std::string _osc_unix_socket_path;
159 std::string _osc_url_file;
160 bool _send_route_changes;
161 OSCDebugMode _debugmode;
163 std::string remote_port;
164 uint32_t default_banksize;
165 uint32_t default_strip;
166 uint32_t default_feedback;
167 uint32_t default_gainmode;
171 boost::shared_ptr<ARDOUR::Stripable> _select; // which stripable out of /surface/stripables is gui selected
173 void register_callbacks ();
175 void route_added (ARDOUR::RouteList&);
177 // Handlers for "Application Hook" signals
178 void session_loaded (ARDOUR::Session&);
179 void session_exported (std::string, std::string);
181 // end "Application Hook" handles
183 std::string get_unix_server_url ();
184 lo_address get_address (lo_message msg);
185 OSCSurface * get_surface (lo_address addr);
186 uint32_t get_sid (boost::shared_ptr<ARDOUR::Stripable> strip, lo_address addr);
187 boost::shared_ptr<ARDOUR::Stripable> get_strip (uint32_t ssid, lo_address addr);
188 void global_feedback (std::bitset<32> feedback, lo_address addr, uint32_t gainmode);
190 void send_current_value (const char* path, lo_arg** argv, int argc, lo_message msg);
191 void current_value_query (const char* path, size_t len, lo_arg **argv, int argc, lo_message msg);
193 int current_value (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data);
195 int catchall (const char *path, const char *types, lo_arg **argv, int argc, void *data);
196 static int _catchall (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data);
198 void routes_list (lo_message msg);
199 void transport_frame (lo_message msg);
200 void transport_speed (lo_message msg);
201 void record_enabled (lo_message msg);
204 if (_debugmode == All) { \
205 debugmsg (dgettext(PACKAGE, "OSC"), path, types, argv, argc); \
208 #define PATH_CALLBACK_MSG(name) \
209 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
210 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
212 int cb_ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data) { \
214 if (argc > 0 && !strcmp (types, "f") && argv[0]->f != 1.0) { return 0; } \
219 PATH_CALLBACK_MSG(routes_list);
220 PATH_CALLBACK_MSG(transport_frame);
221 PATH_CALLBACK_MSG(transport_speed);
222 PATH_CALLBACK_MSG(record_enabled);
223 PATH_CALLBACK_MSG(refresh_surface);
224 PATH_CALLBACK_MSG(bank_up);
225 PATH_CALLBACK_MSG(bank_down);
227 #define PATH_CALLBACK(name) \
228 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
229 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
231 int cb_ ## name (const char *path, const char *types, lo_arg ** argv, int argc, void *) { \
233 if (argc > 0 && !strcmp (types, "f") && argv[0]->f != 1.0) { return 0; } \
238 PATH_CALLBACK(add_marker);
239 PATH_CALLBACK(loop_toggle);
240 PATH_CALLBACK(goto_start);
241 PATH_CALLBACK(goto_end);
242 PATH_CALLBACK(rewind);
244 PATH_CALLBACK(transport_stop);
245 PATH_CALLBACK(transport_play);
246 PATH_CALLBACK(save_state);
247 PATH_CALLBACK(prev_marker);
248 PATH_CALLBACK(next_marker);
251 PATH_CALLBACK(toggle_punch_in);
252 PATH_CALLBACK(toggle_punch_out);
253 PATH_CALLBACK(rec_enable_toggle);
254 PATH_CALLBACK(toggle_all_rec_enables);
255 PATH_CALLBACK(all_tracks_rec_in);
256 PATH_CALLBACK(all_tracks_rec_out);
257 PATH_CALLBACK(cancel_all_solos);
258 PATH_CALLBACK(remove_marker_at_playhead);
259 PATH_CALLBACK(mark_in);
260 PATH_CALLBACK(mark_out);
261 PATH_CALLBACK(toggle_click);
262 PATH_CALLBACK(midi_panic);
263 PATH_CALLBACK(toggle_roll);
264 PATH_CALLBACK(stop_forget);
265 PATH_CALLBACK(set_punch_range);
266 PATH_CALLBACK(set_loop_range);
267 PATH_CALLBACK(set_session_range);
268 PATH_CALLBACK(toggle_monitor_mute);
269 PATH_CALLBACK(toggle_monitor_dim);
270 PATH_CALLBACK(toggle_monitor_mono);
271 PATH_CALLBACK(quick_snapshot_stay);
272 PATH_CALLBACK(quick_snapshot_switch);
273 PATH_CALLBACK(fit_1_track);
274 PATH_CALLBACK(fit_2_tracks);
275 PATH_CALLBACK(fit_4_tracks);
276 PATH_CALLBACK(fit_8_tracks);
277 PATH_CALLBACK(fit_16_tracks);
278 PATH_CALLBACK(fit_32_tracks);
279 PATH_CALLBACK(fit_all_tracks);
280 PATH_CALLBACK(zoom_100_ms);
281 PATH_CALLBACK(zoom_1_sec);
282 PATH_CALLBACK(zoom_10_sec);
283 PATH_CALLBACK(zoom_1_min);
284 PATH_CALLBACK(zoom_5_min);
285 PATH_CALLBACK(zoom_10_min);
286 PATH_CALLBACK(zoom_to_session);
287 PATH_CALLBACK(temporal_zoom_in);
288 PATH_CALLBACK(temporal_zoom_out);
289 PATH_CALLBACK(scroll_up_1_track);
290 PATH_CALLBACK(scroll_dn_1_track);
291 PATH_CALLBACK(scroll_up_1_page);
292 PATH_CALLBACK(scroll_dn_1_page);
294 #define PATH_CALLBACK1(name,type,optional) \
295 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
296 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
298 int cb_ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *) { \
301 name (optional argv[0]->type); \
306 PATH_CALLBACK1(set_transport_speed,f,);
307 PATH_CALLBACK1(access_action,s,&);
309 PATH_CALLBACK1(jump_by_bars,f,);
310 PATH_CALLBACK1(jump_by_seconds,f,);
311 PATH_CALLBACK1(master_set_gain,f,);
312 PATH_CALLBACK1(master_set_fader,f,);
313 PATH_CALLBACK1(master_set_trim,f,);
314 PATH_CALLBACK1(master_set_mute,i,);
315 PATH_CALLBACK1(monitor_set_gain,f,);
316 PATH_CALLBACK1(monitor_set_fader,f,);
318 #define PATH_CALLBACK1_MSG(name,arg1type) \
319 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
320 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
322 int cb_ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data) { \
325 name (argv[0]->arg1type, data); \
330 // pan position needs message info to send feedback
331 PATH_CALLBACK1_MSG(master_set_pan_stereo_position,f);
333 PATH_CALLBACK1_MSG(set_surface_bank_size,i);
334 PATH_CALLBACK1_MSG(set_surface_strip_types,i);
335 PATH_CALLBACK1_MSG(set_surface_feedback,i);
336 PATH_CALLBACK1_MSG(set_surface_gainmode,i);
337 PATH_CALLBACK1_MSG(sel_recenable,i);
338 PATH_CALLBACK1_MSG(sel_recsafe,i);
339 PATH_CALLBACK1_MSG(sel_mute,i);
340 PATH_CALLBACK1_MSG(sel_solo,i);
341 PATH_CALLBACK1_MSG(sel_solo_iso,i);
342 PATH_CALLBACK1_MSG(sel_solo_safe,i);
343 PATH_CALLBACK1_MSG(sel_monitor_input,i);
344 PATH_CALLBACK1_MSG(sel_monitor_disk,i);
345 PATH_CALLBACK1_MSG(sel_phase,i);
346 PATH_CALLBACK1_MSG(sel_gain,f);
347 PATH_CALLBACK1_MSG(sel_fader,f);
348 PATH_CALLBACK1_MSG(sel_trim,f);
349 PATH_CALLBACK1_MSG(sel_pan_position,f);
350 PATH_CALLBACK1_MSG(sel_pan_width,f);
351 PATH_CALLBACK1_MSG(sel_pan_elevation,f);
352 PATH_CALLBACK1_MSG(sel_pan_frontback,f);
353 PATH_CALLBACK1_MSG(sel_pan_lfe,f);
354 PATH_CALLBACK1_MSG(sel_comp_enable,f);
355 PATH_CALLBACK1_MSG(sel_comp_threshold,f);
356 PATH_CALLBACK1_MSG(sel_comp_speed,f);
357 PATH_CALLBACK1_MSG(sel_comp_mode,f);
358 PATH_CALLBACK1_MSG(sel_comp_makeup,f);
359 PATH_CALLBACK1_MSG(sel_eq_enable,f);
360 PATH_CALLBACK1_MSG(sel_eq_hpf,f);
361 PATH_CALLBACK1_MSG(sel_expand,i);
363 #define PATH_CALLBACK2(name,arg1type,arg2type) \
364 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
365 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
367 int cb_ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *) { \
370 name (argv[0]->arg1type, argv[1]->arg2type); \
375 #define PATH_CALLBACK2_MSG(name,arg1type,arg2type) \
376 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
377 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
379 int cb_ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data) { \
382 name (argv[0]->arg1type, argv[1]->arg2type, data); \
387 #define PATH_CALLBACK3(name,arg1type,arg2type,arg3type) \
388 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
389 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
391 int cb_ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data) { \
394 name (argv[0]->arg1type, argv[1]->arg2type,argv[2]->arg3type, data); \
399 #define PATH_CALLBACK4(name,arg1type,arg2type,arg3type,arg4type) \
400 static int _ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data, void *user_data) { \
401 return static_cast<OSC*>(user_data)->cb_ ## name (path, types, argv, argc, data); \
403 int cb_ ## name (const char *path, const char *types, lo_arg **argv, int argc, void *data) { \
406 name (argv[0]->arg1type, argv[1]->arg2type,argv[2]->arg3type,argv[3]->arg4type, data); \
411 PATH_CALLBACK2_MSG(sel_sendgain,i,f);
412 PATH_CALLBACK2_MSG(sel_sendfader,i,f);
413 PATH_CALLBACK2_MSG(sel_sendenable,i,f);
414 PATH_CALLBACK2_MSG(sel_eq_gain,i,f);
415 PATH_CALLBACK2_MSG(sel_eq_freq,i,f);
416 PATH_CALLBACK2_MSG(sel_eq_q,i,f);
417 PATH_CALLBACK2_MSG(sel_eq_shape,i,f);
419 PATH_CALLBACK4(set_surface,i,i,i,i);
420 PATH_CALLBACK2(locate,i,i);
421 PATH_CALLBACK2(loop_location,i,i);
422 PATH_CALLBACK2_MSG(route_mute,i,i);
423 PATH_CALLBACK2_MSG(route_solo,i,i);
424 PATH_CALLBACK2_MSG(route_solo_iso,i,i);
425 PATH_CALLBACK2_MSG(route_solo_safe,i,i);
426 PATH_CALLBACK2_MSG(route_recenable,i,i);
427 PATH_CALLBACK2_MSG(route_recsafe,i,i);
428 PATH_CALLBACK2_MSG(route_monitor_input,i,i);
429 PATH_CALLBACK2_MSG(route_monitor_disk,i,i);
430 PATH_CALLBACK2_MSG(strip_phase,i,i);
431 PATH_CALLBACK2_MSG(strip_expand,i,i);
432 PATH_CALLBACK2_MSG(strip_gui_select,i,i);
433 PATH_CALLBACK2_MSG(route_set_gain_dB,i,f);
434 PATH_CALLBACK2_MSG(route_set_gain_fader,i,f);
435 PATH_CALLBACK2_MSG(route_set_trim_dB,i,f);
436 PATH_CALLBACK2_MSG(route_set_pan_stereo_position,i,f);
437 PATH_CALLBACK2_MSG(route_set_pan_stereo_width,i,f);
438 PATH_CALLBACK3(route_set_send_gain_dB,i,i,f);
439 PATH_CALLBACK3(route_set_send_fader,i,i,f);
440 PATH_CALLBACK3(route_set_send_enable,i,i,f);
441 PATH_CALLBACK4(route_plugin_parameter,i,i,i,f);
442 PATH_CALLBACK3(route_plugin_parameter_print,i,i,i);
444 int route_mute (int rid, int yn, lo_message msg);
445 int route_solo (int rid, int yn, lo_message msg);
446 int route_solo_iso (int rid, int yn, lo_message msg);
447 int route_solo_safe (int rid, int yn, lo_message msg);
448 int route_recenable (int rid, int yn, lo_message msg);
449 int route_recsafe (int ssid, int yn, lo_message msg);
450 int route_monitor_input (int rid, int yn, lo_message msg);
451 int route_monitor_disk (int rid, int yn, lo_message msg);
452 int strip_phase (int rid, int yn, lo_message msg);
453 int strip_expand (int rid, int yn, lo_message msg);
454 int _strip_select (boost::shared_ptr<ARDOUR::Stripable> s, lo_address addr);
455 int strip_gui_select (int rid, int yn, lo_message msg);
456 int route_set_gain_abs (int rid, float level, lo_message msg);
457 int route_set_gain_dB (int rid, float dB, lo_message msg);
458 int route_set_gain_fader (int rid, float pos, lo_message msg);
459 int route_set_trim_abs (int rid, float level, lo_message msg);
460 int route_set_trim_dB (int rid, float dB, lo_message msg);
461 int route_set_pan_stereo_position (int rid, float left_right_fraction, lo_message msg);
462 int route_set_pan_stereo_width (int rid, float percent, lo_message msg);
463 int route_set_send_gain_dB (int rid, int sid, float val, lo_message msg);
464 int route_set_send_fader (int rid, int sid, float val, lo_message msg);
465 int route_set_send_enable (int rid, int sid, float val, lo_message msg);
466 int route_plugin_parameter (int rid, int piid,int par, float val, lo_message msg);
467 int route_plugin_parameter_print (int rid, int piid,int par, lo_message msg);
470 int set_bank (uint32_t bank_start, lo_message msg);
471 int _set_bank (uint32_t bank_start, lo_address addr);
472 int bank_up (lo_message msg);
473 int bank_down (lo_message msg);
474 int set_surface (uint32_t b_size, uint32_t strips, uint32_t fb, uint32_t gmode, lo_message msg);
475 int set_surface_bank_size (uint32_t bs, lo_message msg);
476 int set_surface_strip_types (uint32_t st, lo_message msg);
477 int set_surface_feedback (uint32_t fb, lo_message msg);
478 int set_surface_gainmode (uint32_t gm, lo_message msg);
479 int refresh_surface (lo_message msg);
481 int master_set_gain (float dB);
482 int master_set_fader (float position);
483 int master_set_trim (float dB);
484 int master_set_pan_stereo_position (float position, lo_message msg);
485 int master_set_mute (uint32_t state);
486 int monitor_set_gain (float dB);
487 int monitor_set_fader (float position);
488 int sel_recenable (uint32_t state, lo_message msg);
489 int sel_recsafe (uint32_t state, lo_message msg);
490 int sel_mute (uint32_t state, lo_message msg);
491 int sel_solo (uint32_t state, lo_message msg);
492 int sel_solo_iso (uint32_t state, lo_message msg);
493 int sel_solo_safe (uint32_t state, lo_message msg);
494 int sel_monitor_input (uint32_t state, lo_message msg);
495 int sel_monitor_disk (uint32_t state, lo_message msg);
496 int sel_phase (uint32_t state, lo_message msg);
497 int sel_gain (float state, lo_message msg);
498 int sel_fader (float state, lo_message msg);
499 int sel_trim (float val, lo_message msg);
500 int sel_pan_position (float val, lo_message msg);
501 int sel_pan_width (float val, lo_message msg);
502 int sel_sendgain (int id, float dB, lo_message msg);
503 int sel_sendfader (int id, float pos, lo_message msg);
504 int sel_sendenable (int id, float pos, lo_message msg);
505 int sel_expand (uint32_t state, lo_message msg);
506 int sel_pan_elevation (float val, lo_message msg);
507 int sel_pan_frontback (float val, lo_message msg);
508 int sel_pan_lfe (float val, lo_message msg);
509 int sel_comp_enable (float val, lo_message msg);
510 int sel_comp_threshold (float val, lo_message msg);
511 int sel_comp_speed (float val, lo_message msg);
512 int sel_comp_mode (float val, lo_message msg);
513 int sel_comp_makeup (float val, lo_message msg);
514 int sel_eq_enable (float val, lo_message msg);
515 int sel_eq_hpf (float val, lo_message msg);
516 int sel_eq_gain (int id, float val, lo_message msg);
517 int sel_eq_freq (int id, float val, lo_message msg);
518 int sel_eq_q (int id, float val, lo_message msg);
519 int sel_eq_shape (int id, float val, lo_message msg);
521 void listen_to_route (boost::shared_ptr<ARDOUR::Stripable>, lo_address);
522 void end_listen (boost::shared_ptr<ARDOUR::Stripable>, lo_address);
523 void drop_route (boost::weak_ptr<ARDOUR::Stripable>);
524 void route_lost (boost::weak_ptr<ARDOUR::Stripable>);
525 void gui_selection_changed (void);
527 void route_name_changed (const PBD::PropertyChange&, boost::weak_ptr<ARDOUR::Route> r, lo_address addr);
529 void _recalcbanks ();
530 void notify_routes_added (ARDOUR::RouteList &);
531 void notify_vca_added (ARDOUR::VCAList &);
533 void update_clock ();
534 int cancel_all_solos ();
535 bool periodic (void);
536 sigc::connection periodic_connection;
537 PBD::ScopedConnectionList session_connections;
539 int route_send_fail (std::string path, uint32_t ssid, float val, lo_address addr);
540 int sel_send_fail (std::string path, uint32_t id, float val, lo_address addr);
541 int sel_fail (std::string path, float val, lo_address addr);
543 typedef std::list<OSCRouteObserver*> RouteObservers;
545 RouteObservers route_observers;
547 typedef std::list<OSCGlobalObserver*> GlobalObservers;
548 GlobalObservers global_observers;
550 void debugmsg (const char *prefix, const char *path, const char* types, lo_arg **argv, int argc);
552 static OSC* _instance;
560 #endif // ardour_osc_h