Input Syntax: Difference between revisions

Revision as of 13:53, 28 July 2016

This page explains how to properly assign multiple inputs and the control expression syntax in the input configuration dialogs.

Detect	Wait for input from the selected device, and highlight the corresponding input in the list.
Select	Copy the selected input name into the control expression field.
\| OR	Copy the selected input name into the control expression field, with "\|" prepended.
& AND	Copy the selected input name into the control expression field, with "&" prepended.
! NOT	Copy the selected input name into the control expression field, with "!" prepended.
+ ADD	Copy the selected input name into the control expression field, with "+" prepended.

Token	Explanation	Example usage
`	The backtick is used in cases where the expression is ambiguous.	`Button 1` results in a syntax error, because the expression is ambiguous. Adding backticks around the button name makes it able to be parsed correctly: `Button 1`
\|	The expression is true if the left-hand side (LHS) or the right-hand side (RHS) are true. (This is not an exclusive OR.) Technically, this is implemented by taking the smaller of the LHS and RHS.	`Button 1` \| `Button 2` The virtual controller button will be pressed if and only if Button 1 and/or Button 2 are pressed.
&	The expression is true if both the LHS and the RHS are true. Technically, this is implemented by taking the greater of the LHS and RHS.	`Button 1` & `Button 2` The virtual controller button will be pressed if and only if both Button 1 and Button 2 are pressed.
!	Negates the following expression's value.	!`Button 1` The virtual controller button will be pressed if and only if Button 1 is not pressed.
+	The expression value is equal to the LHS value and the RHS value summed up, clamped to the 0.0-1.0 range.	`Axis 1+` + `Axis 2+`
(	The left parenthesis is used to open an expression group.	(`Button 1` & `Button 2`) \| `Button 3` The virtual controller button will be pressed if both Button 1 and Button 2 are pressed, and/or Button 3 is pressed.
)	The right parenthesis is used to close an expression group.

@@ Line 36: / Line 36: @@
 | <code>Button 1</code> results in a syntax error, because the expression is ambiguous.
 Adding backticks around the button name makes it able to be parsed correctly: <code>`Button 1`</code>
+|-----------
+! ''&#124;''
+| The expression is true if the left-hand side (LHS) or the right-hand side (RHS) are true. (This is not an exclusive OR.)
+Technically, this is implemented by taking the smaller of the LHS and RHS.
+| <code>`Button 1` &#124; `Button 2`</code>
+The virtual controller button will be pressed if and only if Button 1 and/or Button 2 are pressed.
 |-----------
 ! ''&amp;''
 | The expression is true if both the LHS and the RHS are true.
+Technically, this is implemented by taking the greater of the LHS and RHS.
 | <code>`Button 1` &amp; `Button 2`</code>
 The virtual controller button will be pressed if and only if both Button 1 and Button 2 are pressed.
@@ Line 48: / Line 55: @@
 |-----------
 ! ''+''
-| The expression value is equal to the LHS value and the RHS value summed up.
+| The expression value is equal to the LHS value and the RHS value summed up, clamped to the 0.0-1.0 range.
 | <code>`Axis 1+` + `Axis 2+`</code>
 |-----------