libs/surfaces/mackie/gui.cc

   1 /*
   2         Copyright (C) 2010 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
  19 #include <gtkmm/comboboxtext.h>
  20 #include <gtkmm/box.h>
  21 #include <gtkmm/spinbutton.h>
  22 #include <gtkmm/table.h>
  23 #include <gtkmm/treeview.h>
  24 #include <gtkmm/liststore.h>
  25 #include <gtkmm/treestore.h>
  26 #include <gtkmm/notebook.h>
  27 #include <gtkmm/cellrenderercombo.h>
  28 #include <gtkmm/scale.h>
  29 #include <gtkmm/alignment.h>
  30
  31 #include "pbd/strsplit.h"
  32
  33 #include "gtkmm2ext/utils.h"
  34 #include "gtkmm2ext/actions.h"
  35
  36 #include "ardour/rc_configuration.h"
  37
  38 #include "mackie_control_protocol.h"
  39 #include "device_info.h"
  40 #include "gui.h"
  41
  42 #include "i18n.h"
  43
  44 using namespace std;
  45 using namespace Gtk;
  46 using namespace ArdourSurface;
  47 using namespace Mackie;
  48
  49 void*
  50 MackieControlProtocol::get_gui () const
  51 {
  52         if (!_gui) {
  53                 const_cast<MackieControlProtocol*>(this)->build_gui ();
  54         }
  55         static_cast<Gtk::Notebook*>(_gui)->show_all();
  56         return _gui;
  57 }
  58
  59 void
  60 MackieControlProtocol::tear_down_gui ()
  61 {
  62         if (_gui) {
  63                 Gtk::Widget *w = static_cast<Gtk::Widget*>(_gui)->get_parent();
  64                 if (w) {
  65                         w->hide();
  66                         delete w;
  67                 }
  68         }
  69         delete (MackieControlProtocolGUI*) _gui;
  70         _gui = 0;
  71 }
  72
  73 void
  74 MackieControlProtocol::build_gui ()
  75 {
  76         _gui = (void *) new MackieControlProtocolGUI (*this);
  77 }
  78
  79 MackieControlProtocolGUI::MackieControlProtocolGUI (MackieControlProtocol& p)
  80         : _cp (p)
  81         , touch_sensitivity_adjustment (0, 0, 9, 1, 4)
  82         , touch_sensitivity_scale (touch_sensitivity_adjustment)
  83         , recalibrate_fader_button (_("Recalibrate Faders"))
  84         , ipmidi_base_port_adjustment (_cp.ipmidi_base(), 0, 32767, 1, 1000)
  85         , ipmidi_base_port_spinner (ipmidi_base_port_adjustment)
  86         , discover_button (_("Discover Mackie Devices"))
  87 {
  88         Gtk::Label* l;
  89         Gtk::Alignment* align;
  90
  91         set_border_width (12);
  92
  93         Gtk::Table* table = Gtk::manage (new Gtk::Table (2, 9));
  94         table->set_row_spacings (4);
  95         table->set_col_spacings (6);
  96         table->set_border_width (12);
  97         l = manage (new Gtk::Label (_("Device Type:")));
  98         l->set_alignment (1.0, 0.5);
  99         table->attach (*l, 0, 1, 0, 1, AttachOptions(FILL|EXPAND), AttachOptions(0));
 100         table->attach (_surface_combo, 1, 2, 0, 1, AttachOptions(FILL|EXPAND), AttachOptions(0), 0, 20);
 101
 102         vector<string> surfaces;
 103
 104         for (std::map<std::string,DeviceInfo>::iterator i = DeviceInfo::device_info.begin(); i != DeviceInfo::device_info.end(); ++i) {
 105                 surfaces.push_back (i->first);
 106         }
 107         Gtkmm2ext::set_popdown_strings (_surface_combo, surfaces);
 108         _surface_combo.set_active_text (p.device_info().name());
 109         _surface_combo.signal_changed().connect (sigc::mem_fun (*this, &MackieControlProtocolGUI::surface_combo_changed));
 110
 111         RadioButtonGroup rb_group = absolute_touch_mode_button.get_group();
 112         touch_move_mode_button.set_group (rb_group);
 113
 114         l = manage (new Gtk::Label (_("Button click")));
 115         l->set_alignment (1.0, 0.5);
 116         table->attach (*l, 0, 1, 1, 2, AttachOptions(FILL|EXPAND), AttachOptions (0));
 117         align = manage (new Alignment);
 118         align->set (0.0, 0.5);
 119         align->add (relay_click_button);
 120         table->attach (*align, 1, 2, 1, 2, AttachOptions(FILL|EXPAND), AttachOptions (0));
 121         l = manage (new Gtk::Label (_("Backlight")));
 122         l->set_alignment (1.0, 0.5);
 123         table->attach (*l, 0, 1, 2, 3, AttachOptions(FILL|EXPAND), AttachOptions (0));
 124         align = manage (new Alignment);
 125         align->set (0.0, 0.5);
 126         align->add (backlight_button);
 127         table->attach (*align, 1, 2, 2, 3, AttachOptions(FILL|EXPAND), AttachOptions (0));
 128         l = manage (new Gtk::Label (_("Send Fader Position Only When Touched")));
 129         l->set_alignment (1.0, 0.5);
 130         table->attach (*l, 0, 1, 3, 4, AttachOptions(FILL|EXPAND), AttachOptions (0));
 131         align = manage (new Alignment);
 132         align->set (0.0, 0.5);
 133         align->add (absolute_touch_mode_button);
 134         table->attach (*align, 1, 2, 3, 4, AttachOptions(FILL|EXPAND), AttachOptions (0));
 135         l = manage (new Gtk::Label (_("Send Fader Position When Moved")));
 136         l->set_alignment (1.0, 0.5);
 137         table->attach (*l, 0, 1, 4, 5, AttachOptions(FILL|EXPAND), AttachOptions (0));
 138         align = manage (new Alignment);
 139         align->set (0.0, 0.5);
 140         align->add (touch_move_mode_button);
 141         table->attach (*align, 1, 2, 4, 5, AttachOptions(FILL|EXPAND), AttachOptions (0));
 142         l = manage (new Gtk::Label (_("Fader Touch Sense Sensitivity")));
 143         l->set_alignment (1.0, 0.5);
 144         table->attach (*l, 0, 1, 5, 6, AttachOptions(FILL|EXPAND), AttachOptions (0));
 145         touch_sensitivity_scale.property_digits() = 0;
 146         touch_sensitivity_scale.property_draw_value() = false;
 147         table->attach (touch_sensitivity_scale, 1, 2, 5, 6, AttachOptions(FILL|EXPAND), AttachOptions (0));
 148         table->attach (recalibrate_fader_button, 1, 2, 6, 7, AttachOptions(FILL|EXPAND), AttachOptions (0));
 149
 150         l = manage (new Gtk::Label (_("ipMIDI Port (lowest)")));
 151         l->set_alignment (1.0, 0.5);
 152         table->attach (*l, 0, 1, 7, 8, AttachOptions(FILL|EXPAND), AttachOptions (0));
 153         table->attach (ipmidi_base_port_spinner, 1, 2, 7, 8, AttachOptions(FILL|EXPAND), AttachOptions (0));
 154
 155         ipmidi_base_port_spinner.set_sensitive (_cp.device_info().uses_ipmidi());
 156         ipmidi_base_port_adjustment.signal_value_changed().connect (sigc::mem_fun (*this, &MackieControlProtocolGUI::ipmidi_spinner_changed));
 157
 158
 159         table->attach (discover_button, 1, 2, 8, 9, AttachOptions(FILL|EXPAND), AttachOptions (0));
 160         discover_button.signal_clicked().connect (sigc::mem_fun (*this, &MackieControlProtocolGUI::discover_clicked));
 161
 162         vector<string> profiles;
 163
 164         profiles.push_back ("default");
 165
 166         for (std::map<std::string,DeviceProfile>::iterator i = DeviceProfile::device_profiles.begin(); i != DeviceProfile::device_profiles.end(); ++i) {
 167                 profiles.push_back (i->first);
 168         }
 169         Gtkmm2ext::set_popdown_strings (_profile_combo, profiles);
 170         _profile_combo.set_active_text (p.device_profile().name());
 171         _profile_combo.signal_changed().connect (sigc::mem_fun (*this, &MackieControlProtocolGUI::profile_combo_changed));
 172
 173         append_page (*table, _("Device Setup"));
 174         table->show_all();
 175
 176         /* function key editor */
 177
 178         VBox* fkey_packer = manage (new VBox);
 179         HBox* profile_packer = manage (new HBox);
 180         HBox* observation_packer = manage (new HBox);
 181
 182         l = manage (new Gtk::Label (_("Profile/Settings:")));
 183         profile_packer->pack_start (*l, false, false);
 184         profile_packer->pack_start (_profile_combo, true, true);
 185         profile_packer->set_spacing (12);
 186         profile_packer->set_border_width (12);
 187
 188         l = manage (new Gtk::Label (_("* Button available at the original Mackie MCU PRO or current device if enabled (NOT implemented yet). Device specific name presented.")));
 189         observation_packer->pack_start (*l, false, false);
 190
 191         fkey_packer->pack_start (*profile_packer, false, false);
 192         fkey_packer->pack_start (function_key_scroller, true, true);
 193         fkey_packer->pack_start (*observation_packer, false, false);
 194         fkey_packer->set_spacing (12);
 195         function_key_scroller.property_shadow_type() = Gtk::SHADOW_NONE;
 196         function_key_scroller.add (function_key_editor);
 197         append_page (*fkey_packer, _("Function Keys"));
 198
 199         build_available_action_menu ();
 200         build_function_key_editor ();
 201         refresh_function_key_editor ();
 202         fkey_packer->show_all();
 203 }
 204
 205 CellRendererCombo*
 206 MackieControlProtocolGUI::make_action_renderer (Glib::RefPtr<TreeStore> model, Gtk::TreeModelColumnBase column)
 207 {
 208         CellRendererCombo* renderer = manage (new CellRendererCombo);
 209         renderer->property_model() = model;
 210         renderer->property_editable() = true;
 211         renderer->property_text_column() = 0;
 212         renderer->property_has_entry() = false;
 213         renderer->signal_edited().connect (sigc::bind (sigc::mem_fun(*this, &MackieControlProtocolGUI::action_changed), column));
 214
 215         return renderer;
 216 }
 217
 218 void
 219 MackieControlProtocolGUI::build_available_action_menu ()
 220 {
 221         /* build a model of all available actions (needs to be tree structured
 222          * more)
 223          */
 224
 225         available_action_model = TreeStore::create (available_action_columns);
 226
 227         vector<string> paths;
 228         vector<string> labels;
 229         vector<string> tooltips;
 230         vector<string> keys;
 231         vector<AccelKey> bindings;
 232         typedef std::map<string,TreeIter> NodeMap;
 233         NodeMap nodes;
 234         NodeMap::iterator r;
 235
 236         ActionManager::get_all_actions (labels, paths, tooltips, keys, bindings);
 237
 238         vector<string>::iterator k;
 239         vector<string>::iterator p;
 240         vector<string>::iterator t;
 241         vector<string>::iterator l;
 242
 243         available_action_model->clear ();
 244
 245         for (l = labels.begin(), k = keys.begin(), p = paths.begin(), t = tooltips.begin(); l != labels.end(); ++k, ++p, ++t, ++l) {
 246
 247                 TreeModel::Row row;
 248                 vector<string> parts;
 249
 250                 parts.clear ();
 251
 252                 split (*p, parts, '/');
 253
 254                 if (parts.empty()) {
 255                         continue;
 256                 }
 257
 258                 //kinda kludgy way to avoid displaying menu items as mappable
 259                 if ( parts[1] == _("Main_menu") )
 260                         continue;
 261                 if ( parts[1] == _("JACK") )
 262                         continue;
 263                 if ( parts[1] == _("redirectmenu") )
 264                         continue;
 265                 if ( parts[1] == _("Editor_menus") )
 266                         continue;
 267                 if ( parts[1] == _("RegionList") )
 268                         continue;
 269                 if ( parts[1] == _("ProcessorMenu") )
 270                         continue;
 271
 272                 if ((r = nodes.find (parts[1])) == nodes.end()) {
 273
 274                         /* top level is missing */
 275
 276                         TreeIter rowp;
 277                         TreeModel::Row parent;
 278                         rowp = available_action_model->append();
 279                         nodes[parts[1]] = rowp;
 280                         parent = *(rowp);
 281                         parent[available_action_columns.name] = parts[1];
 282
 283                         row = *(available_action_model->append (parent.children()));
 284
 285                 } else {
 286
 287                         row = *(available_action_model->append ((*r->second)->children()));
 288
 289                 }
 290
 291                 /* add this action */
 292
 293                 if (l->empty ()) {
 294                         row[available_action_columns.name] = *t;
 295                         action_map[*t] = *p;
 296                 } else {
 297                         row[available_action_columns.name] = *l;
 298                         action_map[*l] = *p;
 299                 }
 300
 301                 row[available_action_columns.path] = (*p);
 302         }
 303 }
 304
 305 void
 306 MackieControlProtocolGUI::build_function_key_editor ()
 307 {
 308         function_key_editor.append_column (_("Key"), function_key_columns.name);
 309
 310         TreeViewColumn* col;
 311         CellRendererCombo* renderer;
 312
 313         renderer = make_action_renderer (available_action_model, function_key_columns.plain);
 314         col = manage (new TreeViewColumn (_("Plain"), *renderer));
 315         col->add_attribute (renderer->property_text(), function_key_columns.plain);
 316         function_key_editor.append_column (*col);
 317
 318         renderer = make_action_renderer (available_action_model, function_key_columns.shift);
 319         col = manage (new TreeViewColumn (_("Shift"), *renderer));
 320         col->add_attribute (renderer->property_text(), function_key_columns.shift);
 321         function_key_editor.append_column (*col);
 322
 323         renderer = make_action_renderer (available_action_model, function_key_columns.control);
 324         col = manage (new TreeViewColumn (_("Control"), *renderer));
 325         col->add_attribute (renderer->property_text(), function_key_columns.control);
 326         function_key_editor.append_column (*col);
 327
 328         renderer = make_action_renderer (available_action_model, function_key_columns.option);
 329         col = manage (new TreeViewColumn (_("Option"), *renderer));
 330         col->add_attribute (renderer->property_text(), function_key_columns.option);
 331         function_key_editor.append_column (*col);
 332
 333         renderer = make_action_renderer (available_action_model, function_key_columns.cmdalt);
 334         col = manage (new TreeViewColumn (_("Cmd/Alt"), *renderer));
 335         col->add_attribute (renderer->property_text(), function_key_columns.cmdalt);
 336         function_key_editor.append_column (*col);
 337
 338         renderer = make_action_renderer (available_action_model, function_key_columns.shiftcontrol);
 339         col = manage (new TreeViewColumn (_("Shift+Control"), *renderer));
 340         col->add_attribute (renderer->property_text(), function_key_columns.shiftcontrol);
 341         function_key_editor.append_column (*col);
 342
 343         function_key_model = ListStore::create (function_key_columns);
 344         function_key_editor.set_model (function_key_model);
 345 }
 346
 347 void
 348 MackieControlProtocolGUI::refresh_function_key_editor ()
 349 {
 350         function_key_editor.set_model (Glib::RefPtr<TreeModel>());
 351         function_key_model->clear ();
 352
 353         /* now fill with data */
 354
 355         TreeModel::Row row;
 356         DeviceProfile dp (_cp.device_profile());
 357         DeviceInfo di;
 358
 359         for (int n = 0; n < Mackie::Button::FinalGlobalButton; ++n) {
 360
 361                 Mackie::Button::ID bid = (Mackie::Button::ID) n;
 362
 363                 row = *(function_key_model->append());
 364                 if (di.global_buttons().find (bid) == di.global_buttons().end()) {
 365                         row[function_key_columns.name] = Mackie::Button::id_to_name (bid);
 366                 } else {
 367                         row[function_key_columns.name] = di.get_global_button_name (bid) + "*";
 368                 }
 369                 row[function_key_columns.id] = bid;
 370
 371                 Glib::RefPtr<Gtk::Action> act;
 372                 string action;
 373                 const string defstring = "\u2022";
 374
 375                 action = dp.get_button_action (bid, 0);
 376                 if (action.empty()) {
 377                         row[function_key_columns.plain] = defstring;
 378                 } else {
 379                         act = ActionManager::get_action (action.c_str());
 380                         if (act) {
 381                                 row[function_key_columns.plain] = act->get_label();
 382                         } else {
 383                                 row[function_key_columns.plain] = defstring;
 384                         }
 385                 }
 386
 387                 action = dp.get_button_action (bid, MackieControlProtocol::MODIFIER_CONTROL);
 388                 if (action.empty()) {
 389                         row[function_key_columns.control] = defstring;
 390                 } else {
 391                         act = ActionManager::get_action (action.c_str());
 392                         if (act) {
 393                                 row[function_key_columns.control] = act->get_label();
 394                         } else {
 395                                 row[function_key_columns.control] = defstring;
 396                         }
 397                 }
 398
 399                 action = dp.get_button_action (bid, MackieControlProtocol::MODIFIER_SHIFT);
 400                 if (action.empty()) {
 401                         row[function_key_columns.shift] = defstring;
 402                 } else {
 403                         act = ActionManager::get_action (action.c_str());
 404                         if (act) {
 405                                 row[function_key_columns.shift] = act->get_label();
 406                         } else {
 407                                 row[function_key_columns.shift] = defstring;
 408                         }
 409                 }
 410
 411                 action = dp.get_button_action (bid, MackieControlProtocol::MODIFIER_OPTION);
 412                 if (action.empty()) {
 413                         row[function_key_columns.option] = defstring;
 414                 } else {
 415                         act = ActionManager::get_action (action.c_str());
 416                         if (act) {
 417                                 row[function_key_columns.option] = act->get_label();
 418                         } else {
 419                                 row[function_key_columns.option] = defstring;
 420                         }
 421                 }
 422
 423                 action = dp.get_button_action (bid, MackieControlProtocol::MODIFIER_CMDALT);
 424                 if (action.empty()) {
 425                         row[function_key_columns.cmdalt] = defstring;
 426                 } else {
 427                         act = ActionManager::get_action (action.c_str());
 428                         if (act) {
 429                                 row[function_key_columns.cmdalt] = act->get_label();
 430                         } else {
 431                                 row[function_key_columns.cmdalt] = defstring;
 432                         }
 433                 }
 434
 435                 action = dp.get_button_action (bid, (MackieControlProtocol::MODIFIER_SHIFT|MackieControlProtocol::MODIFIER_CONTROL));
 436                 if (action.empty()) {
 437                         row[function_key_columns.shiftcontrol] = defstring;
 438                 } else {
 439                         act = ActionManager::get_action (action.c_str());
 440                         if (act) {
 441                                 row[function_key_columns.shiftcontrol] = act->get_label();
 442                         } else {
 443                                 row[function_key_columns.shiftcontrol] = defstring;
 444                         }
 445                 }
 446         }
 447
 448         function_key_editor.set_model (function_key_model);
 449 }
 450
 451 void
 452 MackieControlProtocolGUI::action_changed (const Glib::ustring &sPath, const Glib::ustring &text, TreeModelColumnBase col)
 453 {
 454         Gtk::TreePath path(sPath);
 455         Gtk::TreeModel::iterator row = function_key_model->get_iter(path);
 456
 457         if (row) {
 458
 459                 std::map<std::string,std::string>::iterator i = action_map.find (text);
 460
 461                 if (i == action_map.end()) {
 462                         return;
 463                 }
 464
 465                 Glib::RefPtr<Gtk::Action> act = ActionManager::get_action (i->second.c_str());
 466
 467                 if (act) {
 468                         /* update visible text, using string supplied by
 469                            available action model so that it matches and is found
 470                            within the model.
 471                         */
 472                         (*row).set_value (col.index(), text);
 473
 474                         /* update the current DeviceProfile, using the full
 475                          * path
 476                          */
 477
 478                         int modifier;
 479
 480                         switch (col.index()) {
 481                         case 3:
 482                                 modifier = MackieControlProtocol::MODIFIER_SHIFT;
 483                                 break;
 484                         case 4:
 485                                 modifier = MackieControlProtocol::MODIFIER_CONTROL;
 486                                 break;
 487                         case 5:
 488                                 modifier = MackieControlProtocol::MODIFIER_OPTION;
 489                                 break;
 490                         case 6:
 491                                 modifier = MackieControlProtocol::MODIFIER_CMDALT;
 492                                 break;
 493                         case 7:
 494                                 modifier = (MackieControlProtocol::MODIFIER_SHIFT|MackieControlProtocol::MODIFIER_CONTROL);
 495                                 break;
 496                         default:
 497                                 modifier = 0;
 498                         }
 499
 500                         _cp.device_profile().set_button_action ((*row)[function_key_columns.id], modifier, i->second);
 501                 } else {
 502                         std::cerr << "no such action\n";
 503                 }
 504         }
 505 }
 506
 507 void
 508 MackieControlProtocolGUI::surface_combo_changed ()
 509 {
 510         _cp.set_device (_surface_combo.get_active_text());
 511
 512         /* update ipMIDI field */
 513
 514         ipmidi_base_port_spinner.set_sensitive (_cp.device_info().uses_ipmidi());
 515 }
 516
 517 void
 518 MackieControlProtocolGUI::profile_combo_changed ()
 519 {
 520         string profile = _profile_combo.get_active_text();
 521
 522         _cp.set_profile (profile);
 523
 524         refresh_function_key_editor ();
 525 }
 526
 527 void
 528 MackieControlProtocolGUI::ipmidi_spinner_changed ()
 529 {
 530         _cp.set_ipmidi_base ((int16_t) lrintf (ipmidi_base_port_spinner.get_value()));
 531 }
 532
 533 void
 534 MackieControlProtocolGUI::discover_clicked ()
 535 {
 536         /* this should help to get things started */
 537         _cp.midi_connectivity_established ();
 538 }