3. Mouses

#Overview The controller patcher provides support for USB mouses.

In order be write a config file for a mouse, it must contains the following line as first line (case insensitive):

[Mouse]

#Mouse modes An attached mouse has 2 different modes. In one mode it acts like a cursor, like you have it on your computer and in the other its emulating a stick and 2 buttons.

You can switch between these to mode via a attached keyboard. Simply attach a mouse and keyboard and press F1 to enable aimmode. Press it again to switch back to cursormode.

###Cursormode In this mode, a cursor is rendered on to the screen. Hopefully on both screen, but in some games/apps it will just appear in one of them.
When you press the left mouse button, a touch input at the drawn position is emulated.

###Aimmode In this mode the cursor disappears and the left/right mouse button will be mapped to a gamepad button. When you move your mouse upwards, a stick being pushed up is emulated.

#Button mapping The button mapping is just for the aim mode.

##Ignoring default values You can either complety overwrite the default configuration or just modifying parts of it. When you put the following as the **second **line in the config, the default values will be ignored.

[IgnoreDefault]

###Stick In default in the mouse is emulation the RIGHT stick, but you can change it the left stick with the following line:

EMULATED_STICK=VPAD_L_STICK

###Buttons For mapping the mouse buttons, you can use the following settings:

Left mouse click =  LEFT_CLICK
Right mouse click = RIGHT_CLICK

Each mouse button can be set to one of the following values:

A                   =   VPAD_BUTTON_A
B                   =   VPAD_BUTTON_B
X                   =   VPAD_BUTTON_X
Y                   =   VPAD_BUTTON_Y
Plus                =   VPAD_BUTTON_PLUS
Minus               =   VPAD_BUTTON_MINUS
Home                =   VPAD_BUTTON_HOME
Sync                =   VPAD_BUTTON_SYNC
TV                  =   VPAD_BUTTON_TV

DPAD:

DPAD left           =   VPAD_BUTTON_LEFT
DPAD left           =   VPAD_BUTTON_RIGHT
DPAD left           =   VPAD_BUTTON_UP
DPAD left           =   VPAD_BUTTON_DOWN

Trigger:

ZR                  =   VPAD_BUTTON_ZR
ZL                  =   VPAD_BUTTON_ZL
L                   =   VPAD_BUTTON_L
R                   =   VPAD_BUTTON_R

Sticks:
Stick press left    =   VPAD_BUTTON_STICK_L
Stick press right   =   VPAD_BUTTON_STICK_R

##Default configuration: When you provide no extra config file, the following config will be used:

left click = ZR  
right click = R  
emulated stick = right stick 

#Examples Here some examples of full config files: ###Example 1 Mouse emulating the right stick, left click is X and right click is Y (Overwriting the default):

[Mouse]
[IgnoreDefault]
LEFT_CLICK=VPAD_BUTTON_X
RIGHT_CLICK=VPAD_BUTTON_Y

###Example 2 Mouse emulating the left stick, left click is A and right click is B (Overwriting the default):

[Mouse]
[IgnoreDefault]
LEFT_CLICK=VPAD_BUTTON_A
RIGHT_CLICK=VPAD_BUTTON_B
EMULATED_STICK=VPAD_L_STICK

###Example 3 Mouse emulating the left stick, left click is disabled and right click is B (Overwriting the default):

[Mouse]
[IgnoreDefault]
RIGHT_CLICK=VPAD_BUTTON_B
EMULATED_STICK=VPAD_L_STICK

In this case nothing will happen when you click on the left button. Default configuration will be ignored. ###Example 4 Mouse emulating the right stick, left click is ZR (default) and right click is B (Overwriting the default):

[Mouse]
RIGHT_CLICK=VPAD_BUTTON_B

In this case you only need to add the config for the right click. The remainig buttons will be default configuration.

#TODO:

• Adding an option to adjust the sensitivity of the mouse.
• Support for all mouse buttons.