MRShortcutManager.h

Go to the documentation of this file.

#pragma once
#include "MRViewerFwd.h"
#include "MRMesh/MRphmap.h"
#include "MRViewer/MRViewerEventsListener.h"
#include <string>
#include <functional>
#include <optional>
 
namespace MR
{
 
 
struct ShortcutKey
{
    int key{ 0 };
    int mod{ 0 };
 
    bool operator<( const ShortcutKey& other ) const
    {
        if ( key < other.key )
            return true;
        if ( key == other.key )
            return mod < other.mod;
        return false;
    }
};
 
enum class ShortcutCategory : char
{
    Info,
    Edit,
    View,
    Scene,
    Objects,
    Selection,
    Count
};

class MRVIEWER_CLASS ShortcutManager : public MultiListener<KeyDownListener, KeyRepeatListener>
{
public:
    virtual ~ShortcutManager() = default;
 
    using ShortcutKey = MR::ShortcutKey;
    using Category = MR::ShortcutCategory;
 
    struct ShortcutCommand
    {
        Category category;
        std::string name; 
        std::function<void()> action;
        bool repeatable = true; 
    };
 
    inline static const std::string categoryNames[6] = { "Info", "Edit", "View", "Scene", "Objects", "Selection " };

    MRVIEWER_API virtual void setShortcut( const ShortcutKey& key, const ShortcutCommand& command );
 
    using ShortcutList = std::vector<std::tuple<ShortcutKey, Category, std::string>>;

    MRVIEWER_API const ShortcutList& getShortcutList() const;
 
    enum class Reason 
    {
        KeyDown,  
        KeyRepeat 
    };
    
    bool isEnabled() const { return enabled_; }
    void enable( bool on ) { enabled_ = on; }

    MRVIEWER_API virtual bool processShortcut( const ShortcutKey& key, Reason = Reason::KeyDown ) const;
 
    MRVIEWER_API bool onKeyDown_( int key, int modifier ) override;
    MRVIEWER_API bool onKeyRepeat_( int key, int modifier ) override;

    MRVIEWER_API static const char* getModifierString( int mod );
    MRVIEWER_API static std::string getKeyString( int key );
    MRVIEWER_API static std::string getKeyFullString( const ShortcutKey& key, bool respectKey = true );    

    MRVIEWER_API std::optional<ShortcutKey> findShortcutByName( const std::string& name ) const;

    MRVIEWER_API void clear();
protected:
    MRVIEWER_API static int mapKeyFromKeyAndMod( const ShortcutKey& key, bool respectKeyboard );
    static ShortcutKey kayAndModFromMapKey( int mapKey ) { return { mapKey >> 6, mapKey % ( 1 << 6 ) }; }
 
    using ShourtcutsMap = HashMap<int, ShortcutCommand>;
    using ShourtcutsBackMap = HashMap<std::string, int>;
 
    bool enabled_{ true };
 
    ShourtcutsMap map_;
    ShourtcutsBackMap backMap_;
 
    mutable std::optional<ShortcutList> listCache_;
};
 
}