Wah!Cade Default KEYS
=====================
The ~/.wahcade/config/ctrlr/default.ini file maps keyboard & mouse input to 
commands in Wah!Cade.

Currently keyboard control is always turned on.  To turn on mouse control, set 
the "mouse" entry to 1 in the default.ini file (and also set the show_cursor
option to 1 in wahcade.ini).
Joystick controls do not currently work in wahcade, although it should be possible
to use a joystick to keyboard utility such as:
    qjoypad (http://qjoypad.sourceforge.net/)
 or joy2key (http://interreality.org/~tetron/technology/joy2key/)

 
Keyboard mappings can be changes using the Wah!Cade Setup Editor.

Default keyboard setup is:
--------------------------

Key             Command
--------------  -----------------------------------------------
Cursor Up       Up 1 game / menu option / history scroll up
Cursor Down     Down 1 game / menu option / history scroll down
Cursor Left     Up 1 letter in the game list
Cursor Right    Down 1 letter in the game list 
R               Up 1 page / Up 1 history page
F               Down 1 page / Down 1 history page
Shift           Select random game
Tab             Find game
A               Add game to list
S               Remove game from list
Z               Select emulator
X               Select game list
1               Launch game / choose menu option / select game currently screensaver game
2               Display menu / back to previous menu
3               Next game list
4               Next emulator
5               Previous game list
6               Previous emulator
7               Toggle between normal layout and first match of 90, 180 or 270deg rotated layouts. 
I               Launch Application 1 (e.g. MAME History / Control Panel Viewer)
K               Launch Application 2
J               Launch Application 3
Esc             Exit Wah!Cade / Hide MAME History Viewer / Control Panel Viewer


Mouse               Command
--------------      -----------------------------------------------
Scroll Wheel Up     Up 1 game / menu option / history scroll up
Scroll Wheel Down   Down 1 game / menu option / history scroll down
Left click          Select menu option
Double left click   Launch game / choose menu option
Right click         Display menu / back to previous menu



Configuring
-----------
Keyboard, mouse and joystick commands are defined in the ~/.wahcade/ctrlr/default.ini file.
They are mapped to Wah!Cade actions.  

The list of Wah!Cade actions are:
UP_1_GAME                            #move up one game in list
DOWN_1_GAME                          #move down one game in list
UP_1_PAGE                            #move up 1 page in list
DOWN_1_PAGE                          #move down 1 page in list
UP_1_LETTER                          #move back one letter (e.g. from game Dxxxx to Cxxxx)
DOWN_1_LETTER                        #move forward one letter (e.g. from game Dxxxx to Exxxx)

FIND_GAME                            #find a game in the list - brings up a menu, select one letter at a time
RANDOM_GAME                          #jump to a random game in the list
SELECT_EMULATOR                      #select from a list of emulators
NEXT_EMULATOR                        #move to next emulator
PREVIOUS_EMULATOR                    #move to previous emulator
SELECT_GAMELIST                      #select game list for current emulator
NEXT_GAMELIST                        #jump to next game list for current emulator
PREVIOUS_GAMELIST                    #jump to previous game list for current emulator
ADD_GAME_TO_LIST                     #add current game to another list
REMOVE_GAME_FROM_LIST                #remove current game from current list
MENU_SHOW                            #display options menu
MENU_LOCK                            #N/A
LAUNCH_GAME                          #launch current game
LAUNCH_GAME_WITH_OPTIONS1            #launch current game with options #1 (defined in Setup Editor)
LAUNCH_GAME_WITH_OPTIONS2            #launch current game with options #1 (defined in Setup Editor)
LAUNCH_APP_1                         #launch external application 1 (defined in Setup Editor)
LAUNCH_APP_2                         #launch external application 2 (defined in Setup Editor)
LAUNCH_APP_3                         #launch external application 3 (defined in Setup Editor)
EXIT_WITH_CHOICE                     #exit Wah!Cade (display exit menu)
EXIT_TO_WINDOWS                      #exit Wah!Cade (back to desktop)
EXIT_AND_RUN_APP                     #N/A
EXIT_AND_REBOOT                      #exit Wah!Cade (reboot)
EXIT_AND_SHUTDOWN                    #exit Wah!Cade (shutdown)

# New for rotating monitor support
ROTATE_SCREEN_TOGGLE                 #toggle between normal layout (0 degrees) and rotated layout (first to match in 90, 180 or 270 degrees order) 
ROTATE_SCREEN_0                      #select normal layout (0 degrees rotation). Layout file must exist.
ROTATE_SCREEN_90                     #select rotated layout (90 degrees rotation). Layout file must exist.
ROTATE_SCREEN_180                    #select rotated layout (180 degrees rotation). Layout file must exist.
ROTATE_SCREEN_270                    #select rotated layout (270 degrees rotation). Layout file must exist.

# options form
OP_UP_1_OPTION                       #move up one item in options list
OP_DOWN_1_OPTION                     #move down one item in options list
OP_UP_1_OPTION_PAGE                  #move up one page in options list
OP_DOWN_1_OPTION_PAGE                #move down one page in options list
OP_MENU_SELECT                       #select current item in options list
OP_MENU_BACK                         #go back to previous options menu
OP_MENU_HIDE                         #N/A

# screensaver form
SS_SHOW_TRACK_NAME                   #N/A
SS_FIND_N_SELECT_GAME                #select game in list matching current screen saver game

# any form
PREVIOUS_TRACK                       #select previous track in music playlist
NEXT_TRACK                           #select next track in music playlist
REWIND_TRACK                         #N/A
FF_TRACK                             #N/A



Here's a list of keys and the codes that Wah!Cade currently uses:

#numbers
0: DIK_0
1: DIK_1
2: DIK_2
3: DIK_3
4: DIK_4
5: DIK_5
6: DIK_6
7: DIK_7
8: DIK_8
9: DIK_9

#letters
a: DIK_A
b: DIK_B
c: DIK_C
d: DIK_D
e: DIK_E
f: DIK_F
g: DIK_G
h: DIK_H
i: DIK_I
j: DIK_J
k: DIK_K
l: DIK_L
m: DIK_M
n: DIK_N
o: DIK_O
p: DIK_P
q: DIK_Q
r: DIK_R
s: DIK_S
t: DIK_T
u: DIK_U
v: DIK_V
w: DIK_W
x: DIK_X
y: DIK_Y
z: DIK_Z

#cursor keys
up: DIK_UP or DIK_UPARROW
down: DIK_DOWN or DIK_DOWNARROW
left: DIK_LEFT or DIK_LEFTARROW
right: DIK_RIGHT or DIK_RIGHTARROW

#other
return / enter: DIK_RETURN
backspace: DIK_BACKSPACE or DIK_BACK
tab: DIK_TAB
insert: DIK_INSERT
home: DIK_HOME
page_up: DIK_PGUP or DIK_PRIOR
page_down: DIK_PGDN or DIK_NEXT
delete: DIK_DELETE
end: DIK_END
pause: DIK_PAUSE

#function keys
f1: DIK_F1
f2: DIK_F2
f3: DIK_F3
f4: DIK_F4
f5: DIK_F5
f6: DIK_F6
f7: DIK_F7
f8: DIK_F8
f9: DIK_F9
f10: DIK_F10
f11: DIK_F11
f12: DIK_F12
f13: DIK_F13
f14: DIK_F14
f15: DIK_F15

#numeric keypad
0: DIK_NUMPAD0
1: DIK_NUMPAD1
2: DIK_NUMPAD2
3: DIK_NUMPAD3
4: DIK_NUMPAD4
5: DIK_NUMPAD5
6: DIK_NUMPAD6
7: DIK_NUMPAD7
8: DIK_NUMPAD8
9: DIK_NUMPAD9
divide: DIK_NUMPADSLASH or DIK_DIVIDE
multiply: DIK_NUMPADSTAR or DIK_MULTIPLY
subtract: DIK_NUMPADMINUS or DIK_SUBTRACT
add: DIK_NUMPADPLUS or DIK_ADD
enter: DIK_NUMPADENTER
decimal: DIK_NUMPADPERIOD or DIK_DECIMAL

#punctuation 
grave: DIK_GRAVE
backslash: DIK_BACKSLASH
minus: DIK_MINUS
equal: DIK_EQUALS or DIK_NUMPADEQUALS
left bracket: DIK_LBRACKET
right bracket: DIK_RBRACKET
semicolon: DIK_SEMICOLON
apostrophe: DIK_APOSTROPHE
comma: DIK_COMMA or DIK_NUMPADCOMMA
period: DIK_PERIOD
slash: DIK_SLASH
space: DIK_SPACE

#modifier keys
escape: DIK_ESCAPE
left shift: DIK_LSHIFT
right shift: DIK_RSHIFT
left control: DIK_LCONTROL
right control: DIK_RCONTROL
left meta (windows): DIK_LWIN
right meta (windows): DIK_RWIN
left alt: DIK_LALT DIK_LMENU
right alt: DIK_RALT
menu: DIK_RMENU
caps lock: DIK_CAPSLOCK
num lock: DIK_NUMLOCK
scroll lock: DIK_SCROLL


Mouse Controls
--------------
scroll wheel up: MOUSE_SCROLLUP
scroll wheel down: MOUSE_SCROLLDOWN
mouse button 1 (left-click): MOUSE_BUTTON0
mouse button 2 (middle-click): MOUSE_BUTTON1
mouse button 3 (right-click): MOUSE_BUTTON2
mouse button 4: MOUSE_BUTTON3
mouse button 5: MOUSE_BUTTON4
etc...


Notes
-----
* To assign more than one keyboard or mouse input to a Wah!Cade action, use the
  pipe ("|") symbol.
* For more info please see the original MameWAH help document:
    http://mamewah.mameworld.net/docs/ctrlr.txt
    
