1 /***************************************************************************
3 * Open \______ \ ____ ____ | | _\_ |__ _______ ___
4 * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
5 * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
6 * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
9 * Copyright (C) 2004 Brent Coutts
11 * All files in this archive are subject to the GNU General Public License.
12 * See the file COPYING in the source tree root for full license agreement.
14 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
15 * KIND, either express or implied.
17 ****************************************************************************/
24 #define TIMEOUT_BLOCK -1
25 #define TIMEOUT_NOBLOCK 0
27 #define CONTEXT_STOPSEARCHING 0xFFFFFFFF
28 #define CONTEXT_REMOTE 0x80000000 /* | this against another context to get remote buttons for that context */
29 #define CONTEXT_CUSTOM 0x40000000 /* | this against anything to get your context number */
31 #define LAST_ITEM_IN_LIST { CONTEXT_STOPSEARCHING, BUTTON_NONE, BUTTON_NONE }
32 #define LAST_ITEM_IN_LIST__NEXTLIST(a) { a, BUTTON_NONE, BUTTON_NONE }
34 #ifndef HAS_BUTTON_HOLD
35 #define ALLOW_SOFTLOCK 0x20000000 /* will be stripped.. never needed except in calls to get_action() */
37 #define ALLOW_SOFTLOCK 0
42 /* These CONTEXT_ values were here before me,
43 there values may have significance, so dont touch! */
49 /* Add new contexts here, no need to explicitly define a value for them */
51 CONTEXT_SETTINGS
, /* regular setting screens (and debug screens) */
52 /* bellow are setting screens which may need to redefine the standard
53 setting screen keys, targets should return the CONTEXT_SETTINGS
54 keymap unless they are not adequate for the screen
55 NOTE: uses ACTION_STD_[NEXT|PREV] so make sure they are there also
56 and (possibly) ACTION_SETTINGS_[INC|DEC] */
58 CONTEXT_SETTINGS_COLOURCHOOSER
,
59 CONTEXT_SETTINGS_TIME
,
61 /* The following contexts should use ACTION_STD_[NEXT|PREV]
62 and (possibly) ACTION_SETTINGS_[INC|DEC]
63 Also add any extra actions they need */
64 CONTEXT_BOOKMARKSCREEN
, /* uses ACTION_BMS_ defines */
65 CONTEXT_ALARMSCREEN
, /* uses ACTION_AS_ defines */
66 CONTEXT_QUICKSCREEN
, /* uses ACTION_QS_ defines below */
67 CONTEXT_PITCHSCREEN
, /* uses ACTION_PS_ defines below */
69 CONTEXT_YESNOSCREEN
, /*NOTE: make sure your target has this and ACTION_YESNO_ACCEPT */
77 ACTION_NONE
= BUTTON_NONE
,
79 ACTION_REDRAW
, /* returned if keys are locked and we splash()'ed */
81 /* standard actions, use these first */
83 ACTION_STD_PREVREPEAT
,
85 ACTION_STD_NEXTREPEAT
,
91 ACTION_STD_QUICKSCREEN
,
94 ACTION_F3
, /* just so everything works again, possibly change me */
95 /* code context actions */
108 ACTION_WPS_PITCHSCREEN
,/* optional */
109 ACTION_WPS_ID3SCREEN
,/* optional */
111 ACTION_WPS_QUICKSCREEN
,/* optional */
112 ACTION_WPS_MENU
, /*this should be the same as ACTION_STD_MENU */
113 ACTION_WPSAB_SINGLE
, /* No targets use this, but leave n just-in-case! */
114 ACTION_WPS_ABSETA_PREVDIR
, /* these should be safe to put together seen as */
115 ACTION_WPS_ABSETB_NEXTDIR
, /* you shouldnt want to change dir in ab-mode */
118 /* list and tree page up/down */
119 ACTION_LISTTREE_PGUP
,/* optional */
120 ACTION_LISTTREE_PGDOWN
,/* optional */
121 ACTION_LISTTREE_RC_PGUP
,/* optional */
122 ACTION_LISTTREE_RC_PGDOWN
,/* optional */
125 ACTION_TREE_PGLEFT
,/* optional */
126 ACTION_TREE_PGRIGHT
,/* optional */
130 /* recording screen */
145 ACTION_SETTINGS_INCREPEAT
,
146 ACTION_SETTINGS_INCBIGSTEP
,
148 ACTION_SETTINGS_DECREPEAT
,
149 ACTION_SETTINGS_DECBIGSTEP
,
150 ACTION_SETTINGS_RESET
,
152 /* bookmark screen */
157 /* alarm menu screen */
163 ACTION_QS_DOWNINV
, /* why is this not called up?? :p */
166 /* obviously ignore if you dont have thise screen */
171 ACTION_PS_NUDGE_LEFT
,
172 ACTION_PS_NUDGE_RIGHT
,
173 ACTION_PS_NUDGE_LEFTOFF
,
174 ACTION_PS_NUDGE_RIGHTOFF
,
176 ACTION_PS_EXIT
, /* _STD_* isnt going to work here */
181 /* keyboard screen */
184 ACTION_KBD_CURSOR_LEFT
,
185 ACTION_KBD_CURSOR_RIGHT
,
187 ACTION_KBD_SELECT_REM
,
188 ACTION_KBD_PAGE_FLIP
,
191 ACTION_KBD_BACKSPACE
,
194 ACTION_KBD_MORSE_INPUT
,
195 ACTION_KBD_MORSE_SELECT
,
199 struct button_mapping
{
204 /* use if you want to supply your own button mappings, PLUGINS ONLY */
205 /* get_context_map is a function which returns a button_mapping* depedning on the given context */
206 /* custom button_mappings may "chain" to inbuilt CONTEXT's */
207 int get_custom_action(int context
,int timeout
,
208 const struct button_mapping
* (*get_context_map
)(int));
209 /* use if one of the standard CONTEXT_ mappings will work (ALL the core should be using this! */
210 int get_action(int context
, int timeout
);
211 /* call this whenever you leave your button loop */
212 void action_signalscreenchange(void);
214 /* call this if you need to check for ACTION_STD_CANCEL only (i.e user abort! */
215 bool action_userabort(int timeout
);
217 /* no other code should need this apart from action.c */
218 const struct button_mapping
* get_context_mapping(int context
);
219 #ifndef HAS_BUTTON_HOLD
220 bool is_keys_locked(void);