1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
/* bzflag
* Copyright (c) 1993-2025 Tim Riker
*
* This package is free software; you can redistribute it and/or
* modify it under the terms of the license found in the file
* named COPYING that should have accompanied this file.
*
* THIS PACKAGE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*/
/*
* keyboard mapping stuff
*/
#ifndef BZF_KEYMANAGER_H
#define BZF_KEYMANAGER_H
#include "common.h"
// system headers
#include <string>
#include <map>
#include <vector>
// local implementation headers
#include "BzfEvent.h"
#include "CallbackList.h"
#include "Singleton.h"
#define KEYMGR (KeyManager::instance())
class KeyManager : public Singleton<KeyManager>
{
public:
typedef void (*IterateCallback)(const std::string& name, bool press,
const std::string& cmd, void* userData);
typedef IterateCallback ChangeCallback;
// bind/unbind a command to/from a key event press or release
void bind(const BzfKeyEvent&,
bool press, const std::string& cmd);
void unbind(const BzfKeyEvent&, bool press);
// unbind all keys bound to a specific command
void unbindCommand(const char* command);
// get the command for a key event press or release
std::string get(const BzfKeyEvent&, bool press) const;
/** returns a set of keypress strings that correspond to keys bound
* to a particular command
*/
std::vector<std::string> getKeysFromCommand(std::string command, bool press) const;
// convert a key event to/from a string
std::string keyEventToString(const BzfKeyEvent&) const;
bool stringToKeyEvent(const std::string&, BzfKeyEvent&) const;
// invoke callback for each bound key
void iterate(IterateCallback callback, void* userData);
// add/remove a callback to invoke when a key binding is added,
// removed, or changed.
void addCallback(ChangeCallback, void* userData);
void removeCallback(ChangeCallback, void* userData);
protected:
friend class Singleton<KeyManager>;
KeyManager();
~KeyManager();
private:
void notify(const BzfKeyEvent&,
bool press, const std::string& cmd);
struct CallbackInfo
{
public:
std::string name;
bool press;
std::string cmd;
};
static bool onCallback(ChangeCallback, void*, void*);
private:
class KeyEventLess
{
public:
bool operator() (const BzfKeyEvent&,
const BzfKeyEvent&) const;
};
typedef std::map<BzfKeyEvent, std::string, KeyEventLess> EventToCommandMap;
typedef std::map<std::string, BzfKeyEvent> StringToEventMap;
EventToCommandMap pressEventToCommand;
EventToCommandMap releaseEventToCommand;
StringToEventMap stringToEvent;
CallbackList<ChangeCallback> callbacks;
static const char* buttonNames[];
static const char* asciiNames[][2];
};
// this is to be implemented within the requisite source file for the application using it.
// in BZFlag's case, it happens to be in bzflag.cxx
extern const unsigned int numDefaultBindings;
extern const char* defaultBindings[];
#endif // BZF_KEYMANAGER_H
// Local Variables: ***
// mode: C++ ***
// tab-width: 4 ***
// c-basic-offset: 4 ***
// indent-tabs-mode: nil ***
// End: ***
// ex: shiftwidth=4 tabstop=4
|
