Input Syntax: Difference between revisions

Revision as of 18:21, 1 June 2020

This page explains how to properly assign multiple controls (inputs or outputs) 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.
Operator	Contains a list of mathematical operators.
Functions	Contains a list of functions.

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 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.
:	The LHS is used as the device name, and the RHS is used as the control name. The whole expression may need to be wrapped around backticks so it parses correctly.	`evdev/0/Device:Button 0` The virtual controller button will be pressed if Button 0 (from device "evdev/0/Device") is pressed.

Token	Explanation	Example usage
\|	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. Technically, this is implemented by subtracting the value from 1.	!`Button 1` The virtual controller button will be pressed if and only if Button 1 is not pressed.
+	Sums up the LHS value and the RHS value.	`Axis 1+` + `Axis 2+`
-	Subtracts the RHS value from the LHS value.	`Axis 1+` / `Axis 2+`
*	Multiplies LHS value and the RHS value.	`Axis 1+` * `Axis 2+`
/	Divides the LHS value by the RHS value.	`Axis 1+` / `Axis 2+`
%	Gives the value of LHS value modulos RHS value. This means that the remainder of LHS value divided by RHS value is given.	`Axis 1+` % `Axis 2+`
>	The expression is true if the LHS value is bigger than the RHS value.	`Axis 1+` > `Axis 2+`
<	The expression is true if the LHS value is smaller than the RHS value.	`Axis 1+` < `Axis 2+`

@@ Line 69: / Line 69: @@
 ! ''!''
 | Negates the following expression's value.
+Technically, this is implemented by subtracting the value from 1.
 | <code>!`Button 1`</code>
 The virtual controller button will be pressed if and only if Button 1 is not pressed.
 |-----------
 ! ''+''
-| Sums up the LHS value and the RHS value and clamps the sum to the 0.0-1.0 range.
+| Sums up the LHS value and the RHS value.
 | <code>`Axis 1+` + `Axis 2+`</code>
+|-----------
+! ''-''
+| Subtracts the RHS value from the LHS value.
+| <code>`Axis 1+` / `Axis 2+`</code>
+|-----------
+! ''*''
+| Multiplies LHS value and the RHS value.
+| <code>`Axis 1+` * `Axis 2+`</code>
+|-----------
+! ''/''
+| Divides the LHS value by the RHS value.
+| <code>`Axis 1+` / `Axis 2+`</code>
+|-----------
+! ''%''
+| Gives the value of LHS value modulos RHS value.
+This means that the remainder of LHS value divided by RHS value is given.
+| <code>`Axis 1+` % `Axis 2+`</code>
+|-----------
+! ''>''
+| The expression is true if the LHS value is bigger than the RHS value.
+| <code>`Axis 1+` > `Axis 2+`</code>
+|-----------
+! ''<''
+| The expression is true if the LHS value is smaller than the RHS value.
+| <code>`Axis 1+` < `Axis 2+`</code>
 |-----------
 |}