Input Syntax

From Dolphin Emulator Wiki
Revision as of 03:04, 19 December 2015 by Lucario (talk | contribs)
Jump to navigation Jump to search

As a follow-up by right-clicking the button in GameCube, Wiimote, and Hotkey configuration windows, this page explains how to properly assign multiple input and combination of each command in hotkey and controller configuration window.

Assignment Buttons

When opening Configuring Controller window the text cursor will be placed on beginning of lines in small text field.

Detect It will automatically highlight the selected input in the list which can save your time looking through there. It will wait for input from the selected device in Device dropdown for 3 seconds.
Select Assigns the selected input from the list to the current text cursor location in small text field.
| OR Similar to Select, adds " | " before a selected input. Input parameter with | OR can trigger the same command independently. Differences between this and + ADD unknown.
  • Syntax error when selected first.
& AND Similar to Select, adds " & " before a selected input. Input parameter with & AND will wait for the last input parameter to active to trigger the command.
  • Syntax error when selected first.
! NOT Similar to Select, adds "!" before a selected input. Input parameter with ! NOT will disable the next input parameter so that input will not trigger the current command.
  • This is one confusing part, requires additional combination and/or manual editing in the text field. Check the #! NOT example in next section.
+ ADD Similar to Select, adds " + " before a selected input. Input parameter with + ADD can trigger the same command independently. Differences between this and | OR unknown.
  • Syntax error when selected first.

& AND Complexity

The first input parameter with another input parameter containing & AND or | OR will not work when there is another set of two input parameters with & AND after | OR or + ADD.

When adding ! NOT after & AND, input parameters containing these will allow another input parameter with & AND to work.

Parentheses

Using () parentheses can group input parameters together and thus can solve & AND troubles.

The first two parameters don't work.
`Pad W` & `Button X` | `Pad E` & `Button B`
However using parentheses can solve this.
(`Pad W` & `Button X`) | (`Pad E` & `Button B`)

Parameter Examples

This is personalized input combination for Fullscreen in hotkey setting. The first parameter is for Guide (Big "X") button on Xbox 360 controller and the final parameters are for Alt + Enter key combination on keyboard. Both devices can trigger Fullscreen.

Guide | `DInput/0/Keyboard Mouse:RMENU` & `DInput/0/Keyboard Mouse:RETURN`

Using ! NOT

Command will always active unless this input is triggered.
!`Pad W`
Command will active when Button X is pressed, but it won't be triggered when Pad W is also pressed.
!`Pad W` & `Button X`
The first two parameters will not work anymore. #Parentheses can help.
!`Pad W` & `Button X` | !`Pad E` & `Button B`
This will work too.
`Button X` & !`Pad W` | `Button B` & !`Pad E`