/* Copyright (C) 2012 Paul Davis This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #include #include "pbd/gstdio_compat.h" #include #include #include "pbd/convert.h" #include "pbd/debug.h" #include "pbd/error.h" #include "pbd/xml++.h" #include "gtkmm2ext/actions.h" #include "gtkmm2ext/bindings.h" #include "gtkmm2ext/debug.h" #include "gtkmm2ext/keyboard.h" #include "gtkmm2ext/utils.h" #include "i18n.h" using namespace std; using namespace Glib; using namespace Gtk; using namespace Gtkmm2ext; using namespace PBD; list Bindings::bindings; /* global. Gulp */ list ActionMap::action_maps; /* global. Gulp */ PBD::Signal1 Bindings::BindingsChanged; MouseButton::MouseButton (uint32_t state, uint32_t keycode) { uint32_t ignore = ~Keyboard::RelevantModifierKeyMask; /* this is a slightly wierd test that relies on * gdk_keyval_is_{upper,lower}() returning true for keys that have no * case-sensitivity. This covers mostly non-alphanumeric keys. */ if (gdk_keyval_is_upper (keycode) && gdk_keyval_is_lower (keycode)) { /* key is not subject to case, so ignore SHIFT */ ignore |= GDK_SHIFT_MASK; } _val = (state & ~ignore); _val <<= 32; _val |= keycode; }; bool MouseButton::make_button (const string& str, MouseButton& b) { int s = 0; if (str.find ("Primary") != string::npos) { s |= Keyboard::PrimaryModifier; } if (str.find ("Secondary") != string::npos) { s |= Keyboard::SecondaryModifier; } if (str.find ("Tertiary") != string::npos) { s |= Keyboard::TertiaryModifier; } if (str.find ("Level4") != string::npos) { s |= Keyboard::Level4Modifier; } string::size_type lastmod = str.find_last_of ('-'); uint32_t button_number; if (lastmod == string::npos) { button_number = PBD::atoi (str); } else { button_number = PBD::atoi (str.substr (lastmod+1)); } b = MouseButton (s, button_number); return true; } string MouseButton::name () const { int s = state(); string str; if (s & Keyboard::PrimaryModifier) { str += "Primary"; } if (s & Keyboard::SecondaryModifier) { if (!str.empty()) { str += '-'; } str += "Secondary"; } if (s & Keyboard::TertiaryModifier) { if (!str.empty()) { str += '-'; } str += "Tertiary"; } if (s & Keyboard::Level4Modifier) { if (!str.empty()) { str += '-'; } str += "Level4"; } if (!str.empty()) { str += '-'; } char buf[16]; snprintf (buf, sizeof (buf), "%u", button()); str += buf; return str; } KeyboardKey::KeyboardKey (uint32_t state, uint32_t keycode) { uint32_t ignore = ~Keyboard::RelevantModifierKeyMask; _val = (state & ~ignore); _val <<= 32; _val |= keycode; } string KeyboardKey::display_label () const { if (key() == 0) { return string(); } /* This magically returns a string that will display the right thing * on all platforms, notably the command key on OS X. */ uint32_t mod = state(); #ifdef __APPLE__ /* We use both bits (MOD2|META) for Primary on OS X, * but we don't want MOD2 showing up in listings. */ if (mod & GDK_MOD2_MASK) { mod &= ~GDK_MOD2_MASK; } #endif return gtk_accelerator_get_label (key(), (GdkModifierType) mod); } string KeyboardKey::name () const { int s = state(); string str; if (s & Keyboard::PrimaryModifier) { str += "Primary"; } if (s & Keyboard::SecondaryModifier) { if (!str.empty()) { str += '-'; } str += "Secondary"; } if (s & Keyboard::TertiaryModifier) { if (!str.empty()) { str += '-'; } str += "Tertiary"; } if (s & Keyboard::Level4Modifier) { if (!str.empty()) { str += '-'; } str += "Level4"; } if (!str.empty()) { str += '-'; } char const *gdk_name = gdk_keyval_name (key()); if (gdk_name) { str += gdk_name; } else { /* fail! */ return string(); } return str; } bool KeyboardKey::make_key (const string& str, KeyboardKey& k) { int s = 0; if (str.find ("Primary") != string::npos) { s |= Keyboard::PrimaryModifier; } if (str.find ("Secondary") != string::npos) { s |= Keyboard::SecondaryModifier; } if (str.find ("Tertiary") != string::npos) { s |= Keyboard::TertiaryModifier; } if (str.find ("Level4") != string::npos) { s |= Keyboard::Level4Modifier; } string::size_type lastmod = str.find_last_of ('-'); guint keyval; if (lastmod == string::npos) { keyval = gdk_keyval_from_name (str.c_str()); } else { keyval = gdk_keyval_from_name (str.substr (lastmod+1).c_str()); } if (keyval == GDK_VoidSymbol || keyval == 0) { return false; } k = KeyboardKey (s, keyval); return true; } Bindings::Bindings (std::string const& name) : _name (name) , _action_map (0) { bindings.push_back (this); } Bindings::~Bindings() { bindings.remove (this); } string Bindings::ardour_action_name (RefPtr action) { /* Skip "/" */ return action->get_accel_path ().substr (10); } KeyboardKey Bindings::get_binding_for_action (RefPtr action, Operation& op) { const string action_name = ardour_action_name (action); for (KeybindingMap::iterator k = press_bindings.begin(); k != press_bindings.end(); ++k) { /* option one: action has already been associated with the * binding */ if (k->second.action == action) { return k->first; } /* option two: action name matches, so lookup the action, * setup the association while we're here, and return the binding. */ if (_action_map && k->second.action_name == action_name) { k->second.action = _action_map->find_action (action_name); return k->first; } } for (KeybindingMap::iterator k = release_bindings.begin(); k != release_bindings.end(); ++k) { /* option one: action has already been associated with the * binding */ if (k->second.action == action) { return k->first; } /* option two: action name matches, so lookup the action, * setup the association while we're here, and return the binding. */ if (_action_map && k->second.action_name == action_name) { k->second.action = _action_map->find_action (action_name); return k->first; } } return KeyboardKey::null_key(); } void Bindings::set_action_map (ActionMap& actions) { if (_action_map) { _action_map->set_bindings (0); } _action_map = &actions; _action_map->set_bindings (this); dissociate (); associate (); } bool Bindings::empty_keys() const { return press_bindings.empty() && release_bindings.empty(); } bool Bindings::empty_mouse () const { return button_press_bindings.empty() && button_release_bindings.empty(); } bool Bindings::empty() const { return empty_keys() && empty_mouse (); } bool Bindings::activate (KeyboardKey kb, Operation op) { KeybindingMap* kbm = 0; switch (op) { case Press: kbm = &press_bindings; break; case Release: kbm = &release_bindings; break; } /* if shift was pressed, GDK will send us (e.g) 'E' rather than 'e'. Our bindings all use the lower case character/keyname, so switch to the lower case before doing the lookup. */ KeyboardKey unshifted (kb.state(), gdk_keyval_to_lower (kb.key())); KeybindingMap::iterator k = kbm->find (unshifted); if (k == kbm->end()) { /* no entry for this key in the state map */ DEBUG_TRACE (DEBUG::Bindings, string_compose ("no binding for %1\n", unshifted)); return false; } RefPtr action; if (k->second.action) { action = k->second.action; } else { if (_action_map) { action = _action_map->find_action (k->second.action_name); } } if (action) { /* lets do it ... */ DEBUG_TRACE (DEBUG::Bindings, string_compose ("binding for %1: %2\n", unshifted, k->second.action_name)); action->activate (); } /* return true even if the action could not be found */ return true; } void Bindings::associate () { KeybindingMap::iterator k; if (!_action_map) { return; } for (k = press_bindings.begin(); k != press_bindings.end(); ++k) { k->second.action = _action_map->find_action (k->second.action_name); if (k->second.action) { push_to_gtk (k->first, k->second.action); } else { cerr << _name << " didn't find " << k->second.action_name << " in " << _action_map->name() << endl; } } for (k = release_bindings.begin(); k != release_bindings.end(); ++k) { k->second.action = _action_map->find_action (k->second.action_name); /* no working support in GTK for release bindings */ } MouseButtonBindingMap::iterator b; for (b = button_press_bindings.begin(); b != button_press_bindings.end(); ++b) { b->second.action = _action_map->find_action (b->second.action_name); } for (b = button_release_bindings.begin(); b != button_release_bindings.end(); ++b) { b->second.action = _action_map->find_action (b->second.action_name); } } void Bindings::dissociate () { KeybindingMap::iterator k; for (k = press_bindings.begin(); k != press_bindings.end(); ++k) { k->second.action.clear (); } for (k = release_bindings.begin(); k != release_bindings.end(); ++k) { k->second.action.clear (); } } void Bindings::push_to_gtk (KeyboardKey kb, RefPtr what) { /* GTK has the useful feature of showing key bindings for actions in * menus. As of August 2015, we have no interest in trying to * reimplement this functionality, so we will use it even though we no * longer use GTK accelerators for handling key events. To do this, we * need to make sure that there is a fully populated GTK AccelMap set * up with all bindings/actions. */ Gtk::AccelKey gtk_key; bool entry_exists = Gtk::AccelMap::lookup_entry (what->get_accel_path(), gtk_key); if (!entry_exists) { /* there is a trick happening here. It turns out that * gtk_accel_map_add_entry() performs no validation checks on * the accelerator keyval. This means we can use it to define * ANY accelerator, even if they violate GTK's rules * (e.g. about not using navigation keys). This works ONLY when * the entry in the GTK accelerator map has not already been * added. The entries will be added by the GTK UIManager when * building menus, so this code must be called before that * happens. */ Gtk::AccelMap::add_entry (what->get_accel_path(), kb.key(), (Gdk::ModifierType) kb.state()); } } bool Bindings::replace (KeyboardKey kb, Operation op, string const & action_name, bool can_save) { if (!_action_map) { return false; } /* We have to search the existing binding map by both action and * keybinding, because the following are possible: * * - key is already used for a different action * - action has a different binding * - key is not used * - action is not bound */ RefPtr action = _action_map->find_action (action_name); if (!action) { return false; } KeybindingMap* kbm = 0; switch (op) { case Press: kbm = &press_bindings; break; case Release: kbm = &release_bindings; break; } KeybindingMap::iterator k = kbm->find (kb); if (k != kbm->end()) { kbm->erase (k); } /* now linear search by action */ for (k = kbm->begin(); k != kbm->end(); ++k) { if (k->second.action_name == action_name) { kbm->erase (k); break; } } add (kb, op, action_name, can_save); /* for now, this never fails */ return true; } void Bindings::add (KeyboardKey kb, Operation op, string const& action_name, bool can_save) { KeybindingMap* kbm = 0; switch (op) { case Press: kbm = &press_bindings; break; case Release: kbm = &release_bindings; break; } KeybindingMap::iterator k = kbm->find (kb); if (k != kbm->end()) { kbm->erase (k); } KeybindingMap::value_type new_pair (kb, ActionInfo (action_name)); kbm->insert (new_pair).first; if (can_save) { Keyboard::keybindings_changed (); } BindingsChanged (this); /* EMIT SIGNAL */ } void Bindings::remove (KeyboardKey kb, Operation op, bool can_save) { KeybindingMap* kbm = 0; switch (op) { case Press: kbm = &press_bindings; break; case Release: kbm = &release_bindings; break; } KeybindingMap::iterator k = kbm->find (kb); if (k != kbm->end()) { kbm->erase (k); } if (can_save) { Keyboard::keybindings_changed (); } BindingsChanged (this); /* EMIT SIGNAL */ } void Bindings::remove (RefPtr action, Operation op, bool can_save) { KeybindingMap* kbm = 0; switch (op) { case Press: kbm = &press_bindings; break; case Release: kbm = &release_bindings; break; } for (KeybindingMap::iterator k = kbm->begin(); k != kbm->end(); ++k) { if (k->second.action == action) { kbm->erase (k); break; } } if (can_save) { Keyboard::keybindings_changed (); } BindingsChanged (this); /* EMIT SIGNAL */ } bool Bindings::activate (MouseButton bb, Operation op) { MouseButtonBindingMap* bbm = 0; switch (op) { case Press: bbm = &button_press_bindings; break; case Release: bbm = &button_release_bindings; break; } MouseButtonBindingMap::iterator b = bbm->find (bb); if (b == bbm->end()) { /* no entry for this key in the state map */ return false; } RefPtr action; if (b->second.action) { action = b->second.action; } else { if (_action_map) { action = _action_map->find_action (b->second.action_name); } } if (action) { /* lets do it ... */ DEBUG_TRACE (DEBUG::Bindings, string_compose ("activating action %1\n", ardour_action_name (action))); action->activate (); } /* return true even if the action could not be found */ return true; } void Bindings::add (MouseButton bb, Operation op, string const& action_name) { MouseButtonBindingMap* bbm = 0; switch (op) { case Press: bbm = &button_press_bindings; break; case Release: bbm = &button_release_bindings; break; } MouseButtonBindingMap::value_type newpair (bb, ActionInfo (action_name)); bbm->insert (newpair); } void Bindings::remove (MouseButton bb, Operation op) { MouseButtonBindingMap* bbm = 0; switch (op) { case Press: bbm = &button_press_bindings; break; case Release: bbm = &button_release_bindings; break; } MouseButtonBindingMap::iterator b = bbm->find (bb); if (b != bbm->end()) { bbm->erase (b); } } void Bindings::save (XMLNode& root) { XMLNode* presses = new XMLNode (X_("Press")); for (KeybindingMap::iterator k = press_bindings.begin(); k != press_bindings.end(); ++k) { XMLNode* child; if (k->first.name().empty()) { continue; } child = new XMLNode (X_("Binding")); child->add_property (X_("key"), k->first.name()); child->add_property (X_("action"), k->second.action_name); presses->add_child_nocopy (*child); } for (MouseButtonBindingMap::iterator k = button_press_bindings.begin(); k != button_press_bindings.end(); ++k) { XMLNode* child; child = new XMLNode (X_("Binding")); child->add_property (X_("button"), k->first.name()); child->add_property (X_("action"), k->second.action_name); presses->add_child_nocopy (*child); } XMLNode* releases = new XMLNode (X_("Release")); for (KeybindingMap::iterator k = release_bindings.begin(); k != release_bindings.end(); ++k) { XMLNode* child; if (k->first.name().empty()) { continue; } child = new XMLNode (X_("Binding")); child->add_property (X_("key"), k->first.name()); child->add_property (X_("action"), k->second.action_name); releases->add_child_nocopy (*child); } for (MouseButtonBindingMap::iterator k = button_release_bindings.begin(); k != button_release_bindings.end(); ++k) { XMLNode* child; child = new XMLNode (X_("Binding")); child->add_property (X_("button"), k->first.name()); child->add_property (X_("action"), k->second.action_name); releases->add_child_nocopy (*child); } root.add_child_nocopy (*presses); root.add_child_nocopy (*releases); } bool Bindings::load (XMLNode const& node) { const XMLNodeList& children (node.children()); press_bindings.clear (); release_bindings.clear (); for (XMLNodeList::const_iterator i = children.begin(); i != children.end(); ++i) { /* each node could be Press or Release */ load_operation (**i); } return true; } void Bindings::load_operation (XMLNode const& node) { if (node.name() == X_("Press") || node.name() == X_("Release")) { Operation op; if (node.name() == X_("Press")) { op = Press; } else { op = Release; } const XMLNodeList& children (node.children()); for (XMLNodeList::const_iterator p = children.begin(); p != children.end(); ++p) { XMLProperty* ap; XMLProperty* kp; XMLProperty* bp; ap = (*p)->property ("action"); kp = (*p)->property ("key"); bp = (*p)->property ("button"); if (!ap || (!kp && !bp)) { continue; } if (kp) { KeyboardKey k; if (!KeyboardKey::make_key (kp->value(), k)) { continue; } add (k, op, ap->value()); } else { MouseButton b; if (!MouseButton::make_button (bp->value(), b)) { continue; } add (b, op, ap->value()); } } } } void Bindings::get_all_actions (std::vector& paths, std::vector& labels, std::vector& tooltips, std::vector& keys, std::vector >& actions) { if (!_action_map) { return; } /* build a reverse map from actions to bindings */ typedef map,KeyboardKey> ReverseMap; ReverseMap rmap; for (KeybindingMap::const_iterator k = press_bindings.begin(); k != press_bindings.end(); ++k) { rmap.insert (make_pair (k->second.action, k->first)); } /* get a list of all actions */ ActionMap::Actions all_actions; _action_map->get_actions (all_actions); for (ActionMap::Actions::const_iterator act = all_actions.begin(); act != all_actions.end(); ++act) { paths.push_back ((*act)->get_accel_path()); labels.push_back ((*act)->get_label()); tooltips.push_back ((*act)->get_tooltip()); ReverseMap::iterator r = rmap.find (*act); if (r != rmap.end()) { keys.push_back (r->second.display_label()); } else { keys.push_back (string()); } actions.push_back (*act); } } Bindings* Bindings::get_bindings (string const& name, ActionMap& map) { for (list::iterator b = bindings.begin(); b != bindings.end(); b++) { if ((*b)->name() == name) { (*b)->set_action_map (map); return *b; } } return 0; } void Bindings::associate_all () { for (list::iterator b = bindings.begin(); b != bindings.end(); b++) { (*b)->associate (); } } /*==========================================ACTION MAP =========================================*/ ActionMap::ActionMap (string const & name) : _name (name) , _bindings (0) { action_maps.push_back (this); } ActionMap::~ActionMap () { action_maps.remove (this); } void ActionMap::set_bindings (Bindings* b) { _bindings = b; } void ActionMap::get_actions (ActionMap::Actions& acts) { for (_ActionMap::iterator a = _actions.begin(); a != _actions.end(); ++a) { acts.push_back (a->second); } } RefPtr ActionMap::find_action (const string& name) { _ActionMap::iterator a = _actions.find (name); if (a != _actions.end()) { return a->second; } return RefPtr(); } RefPtr ActionMap::create_action_group (const string& name) { RefPtr g = ActionGroup::create (name); /* this is one of the places where our own Action management code has to touch the GTK one, because we want the GtkUIManager to be able to create widgets (particularly Menus) from our actions. This is a a necessary step for that to happen. */ if (g) { ActionManager::ui_manager->insert_action_group (g); } return g; } RefPtr ActionMap::register_action (RefPtr group, const char* name, const char* label) { string fullpath; RefPtr act = Action::create (name, label); fullpath = group->get_name(); fullpath += '/'; fullpath += name; if (_actions.insert (_ActionMap::value_type (fullpath, act)).second) { group->add (act); return act; } /* already registered */ return RefPtr (); } RefPtr ActionMap::register_action (RefPtr group, const char* name, const char* label, sigc::slot sl) { string fullpath; RefPtr act = Action::create (name, label); fullpath = group->get_name(); fullpath += '/'; fullpath += name; if (_actions.insert (_ActionMap::value_type (fullpath, act)).second) { group->add (act, sl); return act; } /* already registered */ return RefPtr(); } RefPtr ActionMap::register_radio_action (RefPtr group, Gtk::RadioAction::Group& rgroup, const char* name, const char* label, sigc::slot sl) { string fullpath; RefPtr act = RadioAction::create (rgroup, name, label); RefPtr ract = RefPtr::cast_dynamic(act); fullpath = group->get_name(); fullpath += '/'; fullpath += name; if (_actions.insert (_ActionMap::value_type (fullpath, act)).second) { group->add (act, sl); return act; } /* already registered */ return RefPtr(); } RefPtr ActionMap::register_radio_action (RefPtr group, Gtk::RadioAction::Group& rgroup, const char* name, const char* label, sigc::slot sl, int value) { string fullpath; RefPtr act = RadioAction::create (rgroup, name, label); RefPtr ract = RefPtr::cast_dynamic(act); ract->property_value() = value; fullpath = group->get_name(); fullpath += '/'; fullpath += name; if (_actions.insert (_ActionMap::value_type (fullpath, act)).second) { group->add (act, sigc::bind (sl, act->gobj())); return act; } /* already registered */ return RefPtr(); } RefPtr ActionMap::register_toggle_action (RefPtr group, const char* name, const char* label, sigc::slot sl) { string fullpath; fullpath = group->get_name(); fullpath += '/'; fullpath += name; RefPtr act = ToggleAction::create (name, label); if (_actions.insert (_ActionMap::value_type (fullpath, act)).second) { group->add (act, sl); return act; } /* already registered */ return RefPtr(); } void ActionMap::get_all_actions (std::vector& paths, std::vector& labels, std::vector& tooltips, std::vector& keys, std::vector >& actions) { for (list::const_iterator map = action_maps.begin(); map != action_maps.end(); ++map) { ActionMap::Actions these_actions; (*map)->get_actions (these_actions); for (ActionMap::Actions::const_iterator act = these_actions.begin(); act != these_actions.end(); ++act) { paths.push_back ((*act)->get_accel_path()); labels.push_back ((*act)->get_label()); tooltips.push_back ((*act)->get_tooltip()); actions.push_back (*act); Bindings* bindings = (*map)->bindings(); if (bindings) { KeyboardKey key; Bindings::Operation op; key = bindings->get_binding_for_action (*act, op); if (key == KeyboardKey::null_key()) { keys.push_back (string()); } else { keys.push_back (key.display_label()); } } else { keys.push_back (string()); } } these_actions.clear (); } } std::ostream& operator<<(std::ostream& out, Gtkmm2ext::KeyboardKey const & k) { char const *gdk_name = gdk_keyval_name (k.key()); return out << "Key " << k.key() << " (" << (gdk_name ? gdk_name : "no-key") << ") state " << hex << k.state() << dec; }