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
122
|
/* Copyright (C) 2007-2008 The Android Open Source Project
**
** This software is licensed under the terms of the GNU General Public
** License version 2, as published by the Free Software Foundation, and
** may be copied, distributed, and modified under those terms.
**
** 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.
*/
#ifndef _ANDROID_SKIN_KEYSET_H_
#define _ANDROID_SKIN_KEYSET_H_
#include "android_config.h"
/* A SkinKeySet maps keystrokes to specific commands. we have a few hard-coded
* keysets in the emulator binary, and the user can define its own if he wants
* to...
*/
typedef struct SkinKeyset SkinKeyset;
#define SKIN_KEY_COMMAND_LIST \
_SKIN_KEY_COMMAND(NONE,"no key") \
_SKIN_KEY_COMMAND(BUTTON_HOME,"Home button") \
_SKIN_KEY_COMMAND(BUTTON_MENU,"Menu (Soft-Left) button") \
_SKIN_KEY_COMMAND(BUTTON_STAR,"Star (Soft-Right) button") \
_SKIN_KEY_COMMAND(BUTTON_BACK,"Back button") \
_SKIN_KEY_COMMAND(BUTTON_CALL,"Call/Dial button") \
_SKIN_KEY_COMMAND(BUTTON_HANGUP,"Hangup/EndCall button") \
_SKIN_KEY_COMMAND(BUTTON_POWER,"Power button") \
_SKIN_KEY_COMMAND(BUTTON_SEARCH,"Search button") \
_SKIN_KEY_COMMAND(BUTTON_VOLUME_UP,"Volume up button") \
_SKIN_KEY_COMMAND(BUTTON_VOLUME_DOWN,"Volume down button") \
_SKIN_KEY_COMMAND(BUTTON_CAMERA,"Camera button") \
_SKIN_KEY_COMMAND(CHANGE_LAYOUT_PREV,"switch to previous layout") \
_SKIN_KEY_COMMAND(CHANGE_LAYOUT_NEXT,"switch to next layout") \
_SKIN_KEY_COMMAND(TOGGLE_NETWORK,"toggle cell network on/off") \
_SKIN_KEY_COMMAND(TOGGLE_TRACING,"toggle code profiling") \
_SKIN_KEY_COMMAND(TOGGLE_FULLSCREEN,"toggle fullscreen mode") \
_SKIN_KEY_COMMAND(TOGGLE_TRACKBALL,"toggle trackball mode") \
_SKIN_KEY_COMMAND(SHOW_TRACKBALL,"show trackball") \
_SKIN_KEY_COMMAND(BUTTON_DPAD_CENTER,"DPad center") \
_SKIN_KEY_COMMAND(BUTTON_DPAD_LEFT,"DPad left") \
_SKIN_KEY_COMMAND(BUTTON_DPAD_RIGHT,"DPad right") \
_SKIN_KEY_COMMAND(BUTTON_DPAD_UP,"DPad up") \
_SKIN_KEY_COMMAND(BUTTON_DPAD_DOWN,"DPad down") \
_SKIN_KEY_COMMAND(ONION_ALPHA_UP,"increase onion alpha") \
_SKIN_KEY_COMMAND(ONION_ALPHA_DOWN,"decrease onion alpha") \
/* the list of commands in the emulator */
#define _SKIN_KEY_COMMAND(x,y) SKIN_KEY_COMMAND_##x,
typedef enum {
SKIN_KEY_COMMAND_LIST
SKIN_KEY_COMMAND_MAX // do not remove
} SkinKeyCommand;
#undef _SKIN_KEY_COMMAND
/* retrieve the textual name of a given command, this is the command name without
* the "SKIN_KEY_COMMAND_" prefix. returns NULL if command is NONE or invalid
* the result is a static constant string that must not be freed
*/
extern const char* skin_key_command_to_str ( SkinKeyCommand command );
/* convert a string into a SkinKeyCommand. returns SKIN_COMMAND_NONE if the string
* is unknown
*/
extern SkinKeyCommand skin_key_command_from_str( const char* str, int len );
/* returns a short human-friendly description of the command */
extern const char* skin_key_command_description( SkinKeyCommand cmd );
/* returns the number of keysym string descriptors */
extern int skin_keysym_str_count( void );
/* return the n-th keysym string descriptor */
extern const char* skin_keysym_str( int index );
/* convert a (sym,mod) pair into a descriptive string. e.g. "Ctrl-K" or "Alt-A", etc..
* result is a static string that is overwritten on each call
*/
extern const char* skin_key_symmod_to_str ( int sym, int mod );
/* convert a key binding description into a (sym,mod) pair. returns 0 on success, -1
* if the string cannot be parsed.
*/
extern int skin_key_symmod_from_str ( const char* str, int *psym, int *pmod );
/* create a new keyset from a configuration tree node */
extern SkinKeyset* skin_keyset_new ( AConfig* root );
extern SkinKeyset* skin_keyset_new_from_text( const char* text );
/* destroy a given keyset */
extern void skin_keyset_free( SkinKeyset* kset );
/* maximum number of key bindings per command. one command can be bound to several
* key bindings for convenience
*/
#define SKIN_KEY_COMMAND_MAX_BINDINGS 3
/* a structure that describe a key binding */
typedef struct {
int sym; // really a SDL key symbol
int mod; // really a SDL key modifier
} SkinKeyBinding;
/* return the number of keyboard bindings for a given command. results are placed in the 'bindings' array
* which must have at least SKIN_KEY_MAX_BINDINGS items */
extern int skin_keyset_get_bindings( SkinKeyset* kset,
SkinKeyCommand command,
SkinKeyBinding* bindings );
/* return the command for a given keypress - SKIN_KEY_COMMAND_NONE is returned if unknown */
extern SkinKeyCommand skin_keyset_get_command( SkinKeyset* kset, int sym, int mod );
extern const char* skin_keyset_get_default( void );
/* in android_main.c */
extern SkinKeyset* android_keyset;
#endif /* _ANDROID_SKIN_KEYSET_H_ */
|
