summaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/commandline/windowsconfig.rst
diff options
context:
space:
mode:
author Vas Crabb <vas@vastheman.com>2023-02-03 04:27:40 +1100
committer Vas Crabb <vas@vastheman.com>2023-02-03 04:27:40 +1100
commit43e30203bd06e98fd55b491872e5e225faf86eda (patch)
tree84485ae4374c95c64de799ee999c695f792d8e60 /docs/source/commandline/windowsconfig.rst
parent282eedc7f552bc4e1b1f2902f3d98c76620e1c9a (diff)
docs: Clarified documentation of input options.
Made explanation of interaction between device class enable options (-[no]mouse, -[no]joystick, -[no]lightgun) and automatic device class enable options (-*_device) more explicit. Also documented that -mouse_device mouse is set by default in both relevant places. Provided a better explanation of the purpose of -dual_lightgun.
Diffstat (limited to 'docs/source/commandline/windowsconfig.rst')
-rw-r--r--docs/source/commandline/windowsconfig.rst24
1 files changed, 17 insertions, 7 deletions
diff --git a/docs/source/commandline/windowsconfig.rst b/docs/source/commandline/windowsconfig.rst
index dc0cdac3091..1c41476854c 100644
--- a/docs/source/commandline/windowsconfig.rst
+++ b/docs/source/commandline/windowsconfig.rst
@@ -82,10 +82,20 @@ Input device options
**-[no]dual_lightgun** / **-[no]dual**
- Controls whether or not MAME attempts to track two lightguns connected
- simultaneously. This option requires the :ref:`lightgun option
- <mame-commandline-lightgun>` to be on. This option is a hack for supporting
- certain older dual lightgun setups. If you have multiple lightguns
- connected, you will probably just need to enable the :ref:`mouse option
- <mame-commandline-mouse>` and configure each lightgun independently. The
- default is OFF (**-nodual_lightgun**).
+ Controls whether or not MAME attempts to track two lightguns that appear as
+ a single mouse. This option requires the :ref:`lightgun option
+ <mame-commandline-nolightgun>` to be on and the :ref:`lightgunprovider
+ option <mame-commandline-lightgunprovider>` to be set to *win32*.
+
+ This option supports certain older dual lightgun setups that work by setting
+ the mouse pointer location at the moment a lightgun trigger is activated.
+ The primary and secondary triggers on the first lightgun correspond to the
+ first and second mouse buttons, and the primary and secondary triggers on
+ the second lightgun correspond to the third and fourth mouse buttons.
+
+ If you have multiple lightguns connected, you will probably just need to
+ enable the :ref:`lightgun option <mame-commandline-nolightgun>`, use the
+ default :ref:`lightgunprovider option <mame-commandline-lightgunprovider>`
+ of *rawinput*, and configure each lightgun individually.
+
+ The default is OFF (**-nodual_lightgun**).