mame/docs/source/commandline/windowsconfig.rst
Vas Crabb 43e30203bd 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.
2023-02-03 04:27:40 +11:00

102 lines
4.0 KiB
ReStructuredText

Windows-Specific Command-line Options
=====================================
This section contains configuration options that are specific to the native
(non-SDL) Windows version of MAME.
Performance options
-------------------
.. _mame-wcommandline-priority:
**-priority** *<priority>*
Sets the thread priority for the MAME threads. By default the priority is
left alone to guarantee proper cooperation with other applications. The
valid range is -15 to 1, with 1 being the highest priority. The default is
*0* (*NORMAL priority*).
.. _mame-wcommandline-profile:
**-profile** *[n]*
Enables profiling, specifying the stack depth of *[n]* to track.
Full screen options
-------------------
.. _mame-wcommandline-triplebuffer:
**-[no]triplebuffer** / **-[no]tb**
Enables or disables “triple buffering”. Normally, MAME just draws directly
to the screen, without any fancy buffering. But with this option enabled,
MAME creates three buffers to draw to, and cycles between them in order. It
attempts to keep things flowing such that one buffer is currently displayed,
the second buffer is waiting to be displayed, and the third buffer is being
drawn to. **-triplebuffer** will override **-waitvsync**, if the buffer is
successfully created. This option does not work with **-video gdi**. The
default is OFF (**-notriplebuffer**).
.. _mame-wcommandline-fullscreenbrightness:
**-full_screen_brightness** *<value>* / **-fsb** *<value>*
Controls the brightness, or black level, of the entire display. The
standard value is 1.0. Lower values (down to 0.1) will produce a darkened
display, while higher values (up to 2.0) will give a brighter display. Note
that not all video cards have hardware to support this option. This option
does not work with **-video gdi**. The default is *1.0*.
.. _mame-wcommandline-fullscreencontrast:
**-full_screen_contrast** *<value>* / **-fsc** *<value>*
Controls the contrast, or white level, of the entire display. The standard
value is 1.0. Lower values (down to 0.1) will produce a dimmer display,
while higher values (up to 2.0) will give a more saturated display. Note
that not all video cards have hardware to support this option. This option
does not work with **-video gdi**. The default is *1.0*.
.. _mame-wcommandline-fullscreengamma:
**-full_screen_gamma** *<value>* / **-fsg** *<value>*
Controls the gamma, which produces a potentially nonlinear black to white
ramp, for the entire display. The standard value is 1.0, which gives a
linear ramp from black to white. Lower values (down to 0.1) will increase
the nonlinearity toward black, while higher values (up to 3.0) will push the
nonlinearity toward white. Note that not all video cards have hardware to
support this option. This option does not work with **-video gdi**. The
default is *1.0*.
Input device options
--------------------
.. _mame-wcommandline-duallightgun:
**-[no]dual_lightgun** / **-[no]dual**
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**).