modifiers.cpp

Go to the documentation of this file.

// SPDX-License-Identifier: GPL-2.0-or-later
 * Authors:
 * 2020 Martin Owens <doctormo@geek-2.com>
 *
 * Copyright (C) 2018 Authors
 * Released under GNU GPL v2+, read the file 'COPYING' for more information.
 */
 
#include <cstring>
#include <string>
#include <bitset>
#include <glibmm/i18n.h>
 
#include "modifiers.h"
#include "ui/tools/tool-base.h"
 
namespace Inkscape::Modifiers {
 
namespace {
using ModifierIdToTypeMap = std::map<std::string, Type>;
ModifierIdToTypeMap const &modifier_type_from_id()
{
    static ModifierIdToTypeMap const static_id_to_type_map {
        {"canvas-pan-y", Type::CANVAS_PAN_Y},
        {"canvas-pan-x", Type::CANVAS_PAN_X},
        {"canvas-zoom", Type::CANVAS_ZOOM},
        {"canvas-rotate", Type::CANVAS_ROTATE},
        {"select-add-to", Type::SELECT_ADD_TO},
        {"select-in-groups", Type::SELECT_IN_GROUPS},
        {"select-touch-path", Type::SELECT_TOUCH_PATH},
        {"select-always-box", Type::SELECT_ALWAYS_BOX},
        {"select-remove-from", Type::SELECT_REMOVE_FROM},
        {"select-force-drag", Type::SELECT_FORCE_DRAG},
        {"select-cycle", Type::SELECT_CYCLE},
        {"move-confine", Type::MOVE_CONFINE},
        {"move-increment", Type::MOVE_INCREMENT},
        {"move-snapping", Type::MOVE_SNAPPING},
        {"trans-confine", Type::TRANS_CONFINE},
        {"trans-increment", Type::TRANS_INCREMENT},
        {"trans-off-center", Type::TRANS_OFF_CENTER},
        {"trans-snapping", Type::TRANS_SNAPPING},
        {"bool-shift", Type::BOOL_SHIFT},
        {"node-grow-linear", Type::NODE_GROW_LINEAR},
        {"node-invert", Type::NODE_INVERT},
        {"node-remove-from", Type::NODE_REMOVE_FROM},
        {"node-grow-spatial", Type::NODE_GROW_SPATIAL}
    };
    return static_id_to_type_map;
}
 
inline std::pair<Modifiers::Type, Modifier> make_modifier(char const *id,
                                                          char const *name,
                                                          char const *desc,
                                                          KeyMask and_mask,
                                                          Trigger category,
                                                          Trigger trigger)
{
    return {modifier_type_from_id().at(id), Modifier(id, name, desc, and_mask, category, trigger)};
}
 
std::map<int, int> const &key_map()
{
    static const std::map<int, int> static_key_map = {
        {GDK_KEY_Alt_L, GDK_ALT_MASK},
        {GDK_KEY_Alt_R, GDK_ALT_MASK},
        {GDK_KEY_Control_L, GDK_CONTROL_MASK},
        {GDK_KEY_Control_R, GDK_CONTROL_MASK},
        {GDK_KEY_Shift_L, GDK_SHIFT_MASK},
        {GDK_KEY_Shift_R, GDK_SHIFT_MASK},
        {GDK_KEY_Meta_L, GDK_META_MASK},
        {GDK_KEY_Meta_R, GDK_META_MASK},
    };
    return static_key_map;
}
}  // end anonymous namespace
 
Modifier::Container &Modifier::_modifiers()
{
    // these must be in the same order as the * enum in "modifiers.h"
    static Modifier::Container static_modifiers {
    // Canvas modifiers
        make_modifier("canvas-pan-y", _("Vertical pan"), _("Pan/Scroll up and down"), ALWAYS, CANVAS, SCROLL),
        make_modifier("canvas-pan-x", _("Horizontal pan"), _("Pan/Scroll left and right"), SHIFT, CANVAS, SCROLL),
        make_modifier("canvas-zoom", _("Canvas zoom"), _("Zoom in and out with scroll wheel"), CTRL, CANVAS, SCROLL),
        make_modifier("canvas-rotate", _("Canvas rotate"), _("Rotate the canvas with scroll wheel"), SHIFT | CTRL, CANVAS, SCROLL),
 
    // Select tool modifiers (minus transforms)
        make_modifier("select-add-to", _("Add to selection"), _("Add items to existing selection"), SHIFT, SELECT, CLICK),
        make_modifier("select-in-groups", _("Select inside groups"), _("Ignore groups when selecting items"), CTRL, SELECT, CLICK),
        make_modifier("select-touch-path", _("Select with touch-path"), _("Draw a band around items to select them"), ALT, SELECT, DRAG),
        make_modifier("select-always-box", _("Select with box"), _("Don't drag items, select more with a box"), SHIFT, SELECT, DRAG),
        make_modifier("select-remove-from", _("Remove from selection"), _("Remove items from existing selection"), CTRL, SELECT, DRAG),
        make_modifier("select-force-drag", _("Forced Drag"), _("Drag objects even if the mouse isn't over them"), ALT, SELECT, DRAG),
        make_modifier("select-cycle", _("Cycle through objects"), _("Scroll through objects under the cursor"), ALT, SELECT, SCROLL),
 
    // Transform handle modifiers (applies to multiple tools)
        make_modifier("move-confine", _("Move one axis only"), _("When dragging items, confine to either x or y axis"), CTRL, MOVE, DRAG),
        make_modifier("move-increment", _("Move in increments"), _("Move the objects by set increments when dragging"), ALT, MOVE, DRAG),
        make_modifier("move-snapping", _("No Move Snapping"), _("Disable snapping when moving objects"), SHIFT, MOVE, DRAG),
        make_modifier("trans-confine", _("Keep aspect ratio"), _("When resizing objects, confine the aspect ratio"), CTRL, TRANSFORM, DRAG),
        make_modifier("trans-increment", _("Transform in increments"), _("Scale, rotate or skew by set increments"), ALT, TRANSFORM, DRAG),
        make_modifier("trans-off-center", _("Transform around center"), _("When scaling, scale selection symmetrically around its rotation center. When rotating/skewing, transform relative to opposite corner/edge."), SHIFT, TRANSFORM, DRAG),
        make_modifier("trans-snapping", _("No Transform Snapping"), _("Disable snapping when transforming object."), SHIFT, TRANSFORM, DRAG),
    // Center handle click: seltrans.cpp:734 SHIFT
    // Align handle click: seltrans.cpp:1365 SHIFT
        make_modifier("bool-shift", _("Switch mode"), _("Change shape builder mode temporarily by holding a modifier key."), SHIFT, BOOLEANS_TOOL, DRAG),
 
        make_modifier("node-grow-linear", _("Linear node selection"), _("Select the next nodes with scroll wheel or keyboard"), CTRL, NODE_TOOL, SCROLL),
        make_modifier("node-invert", _("Inverted node selection"), _("Select nodes outside the selection area"), CTRL, NODE_TOOL, DRAG),
        make_modifier("node-remove-from", _("Remove nodes from selection"), _("Remove selected nodes from the selection"), SHIFT | CTRL, NODE_TOOL, DRAG),
        make_modifier("node-grow-spatial", _("Spatial node selection"), _("Select more nodes with scroll wheel or keyboard"), ALWAYS, NODE_TOOL, SCROLL),
    };
    return static_modifiers;
}
 
Modifier::CategoryNames const &Modifier::_category_names()
{
    static Modifier::CategoryNames const static_category_names {
        {NO_CATEGORY, _("No Category")},
        {CANVAS, _("Canvas")},
        {SELECT, _("Selection")},
        {MOVE, _("Movement")},
        {TRANSFORM, _("Transformations")},
        {NODE_TOOL, _("Node Tool")},
        {BOOLEANS_TOOL, _("Shape Builder")},
    };
    return static_category_names;
}
 
Type Modifier::which(Trigger trigger, int button_state)
{
    // Record each active modifier with it's weight
    std::map<Type, unsigned long> scales;
    for (auto const &[key, val] : _modifiers()) {
        if (val.get_trigger() == trigger && val.active(button_state)) {
            scales[key] = val.get_weight();
        }
    }
    // Sort the weightings
    using pair_type = decltype(scales)::value_type;
    auto sorted = std::max_element
    (
        std::begin(scales), std::end(scales),
        [] (const pair_type & p1, const pair_type & p2) {
            return p1.second < p2.second;
        }
    );
    return sorted->first;
}
 
std::vector<Modifier const *> Modifier::getList()
{
    std::vector<Modifier const *> modifiers;
    // Go through the dynamic modifier table
    for (auto const &[_, val] : _modifiers()) {
        modifiers.push_back(&val);
    }
 
    return modifiers;
}
 
Modifier *Modifier::get(char const *id)
{
    auto const type_it = modifier_type_from_id().find(id);
    if (type_it == modifier_type_from_id().end()) {
        return nullptr;
    }
    auto const modifier_it = _modifiers().find(type_it->second);
    if (modifier_it == _modifiers().end()) {
        return nullptr;
    }
    return &(modifier_it->second);
}
 
bool Modifier::active(int state) const
{
    // TODO:
    //  * ALT key is sometimes MOD1, MOD2 etc, if we find other ALT keys, set the ALT bit
    //  * SUPER key could be HYPER or META, these cases need to be considered.
    auto and_mask = get_and_mask();
    auto not_mask = get_not_mask();
    auto active = Key::ALL_MODS & state;
    // Check that all keys in AND mask are pressed, and NONE of the NOT mask are.
    return and_mask != NEVER && ((active & and_mask) == and_mask) && (not_mask == NOT_SET || (active & not_mask) == 0);
}
 
bool Modifier::active(int state, int keyval, bool release) const
{
    return active(add_keyval(state, keyval, release));
}
 
std::string generate_label(KeyMask mask, std::string sep)
{
    auto ret = std::string();
    if(mask == NOT_SET) {
        return "-";
    }
    if(mask == NEVER) {
        ret.append(_("[NEVER]"));
        return ret;
    }
    if(mask & CTRL) ret.append(_("Ctrl"));
    if(mask & SHIFT) {
        if(!ret.empty()) ret.append(sep);
        ret.append(_("Shift"));
    }
    if(mask & ALT) {
        if(!ret.empty()) ret.append(sep);
        ret.append(_("Alt"));
    }
    if(mask & SUPER) {
        if(!ret.empty()) ret.append(sep);
        ret.append(_("Super"));
    }
    if(mask & HYPER) {
        if(!ret.empty()) ret.append(sep);
        ret.append(_("Hyper"));
    }
    if(mask & META) {
        if(!ret.empty()) ret.append(sep);
        ret.append(_("Meta"));
    }
    return ret;
}
 
unsigned long calculate_weight(KeyMask mask)
{
 
    if (mask < 0)
        return 0;
    std::bitset<sizeof(mask)> bit_mask(mask);
    return bit_mask.count();
}
 
void responsive_tooltip(MessageContext *message_context, KeyEvent const &event, int num_args, ...)
{
    std::string ctrl_msg = "<b>Ctrl</b>: ";
    std::string shift_msg = "<b>Shift</b>: ";
    std::string alt_msg = "<b>Alt</b>: ";
 
    // NOTE: This will hide any keys changed to SUPER or multiple keys such as CTRL+SHIFT
    va_list args;
    va_start(args, num_args);
    for(int i = 0; i < num_args; i++) {
        auto modifier = Modifier::get(va_arg(args, Type));
        auto name = std::string(_(modifier->get_name()));
        switch (modifier->get_and_mask()) {
            case CTRL:
                ctrl_msg += name + ", ";
                break;
            case SHIFT:
                shift_msg += name + ", ";
                break;
            case ALT:
                alt_msg += name + ", ";
                break;
            default:
                g_warning("Unhandled responsivle tooltip: %s", name.c_str());
        }
    }
    va_end(args);
    ctrl_msg.erase(ctrl_msg.size() - 2);
    shift_msg.erase(shift_msg.size() - 2);
    alt_msg.erase(alt_msg.size() - 2);
 
    UI::Tools::sp_event_show_modifier_tip(message_context, event,
        ctrl_msg.c_str(), shift_msg.c_str(), alt_msg.c_str());
}
 
int add_keyval(int state, int keyval, bool release)
{
    if (auto it = key_map().find(keyval); it != key_map().end()) {
        if (release)
            state &= ~it->second;
        else
            state |= it->second;
    }
    return state;
}
 
} // namespace Inkscape::Modifiers
 
/*
  Local Variables:
  mode:c++
  c-file-style:"stroustrup"
  c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
  indent-tabs-mode:nil
  fill-column:99
  End:
*/
// vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:fileencoding=utf-8:textwidth=99 :