mame/docs/source/commandline/sdlconfig.rst
Vas Crabb 4ddd26fe21 Initial touch input support:
* Feed mouse/pen/touch pointer events through UI input manager with Win32 and SDL.
* Started migrating UI code to use new API and reworking mouse/touch interaction.
* emu/render.cpp: Support pressing multiple clickable layout items simultaneously.
* emu/render.cpp: Allow UI elements to be drawn in any window.
* emu/rendlay.cpp, luaengine_render.cpp: Added layout view events for pointer input.
* ui/ui.cpp: Allow the UI handler to control pointer display.
* ui/analogipt.cpp: Added mouse/touch and more keys for navigating field state list.
* ui/menu.cpp: Use vertical swipe to scroll and horizontal swipe to adjust.
* ui/menu.cpp: Draw after processing input - greatly improves responsiveness.
* ui/menu.cpp: Ignore keyboard/gamepad input during pointer actions.
* ui/selmenu.cpp: Made left/right info pane arrows repeat when held.
* ui/selmenu.cpp: Use middle click to move keyboard focus.
* ui/selmenu.cpp: Let filter list scroll if it's too tall, and use a bit of horizontal padding.
* ui/selmenu.cpp: Improved divider sizing.
* ui/state.cpp: Don't allow clicks to pass through the confirm deletion prompt to the menu.
* ui/simpleselgame.cpp: Fixed error message display and graphics/sound status not showing.
* ui/simpleselgame.cpp: Allow tap/click to dismiss error message.
* ui/utils.cpp: Show UI for choice filters when there are no choices - it's less confusing.
* modules/input/input_sdl.cpp: Made scaling for mouse scroll better match RawInput and DirectInput.
* modules/input/input_rawinput.cpp: Added support for horizontal scroll axis.
* modules/input/input_win32.cpp: Added support for scroll axes and more buttons to mouse/lightgun.
* modules/debugger/debugimgui.cpp: Don't fight over events with the UI manager - it breaks menus.
* osd/windows/window.cpp: Translate mouse position to window cooridinates for scroll wheel events.
* osd/sdl/window.cpp: Supply last mouse position for scroll wheel events if possible.
* scripts/build/complay.py: Made zero input mask an error - it was only being used to block clicks.
2024-04-12 02:49:15 +10:00

119 lines
2.4 KiB
ReStructuredText
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

SDL-Specific Command-line Options
=================================
This section contains configuration options that are specific to any build
supported by SDL (including Windows when built with SDL instead of native).
Performance Options
-------------------
.. _mame-scommandline-sdlvideofps:
**-[no]sdlvideofps**
Enable output of benchmark data on the SDL video subsystem, including your
systems video driver, X server (if applicable), and OpenGL stack in
**-video opengl** mode.
Video Options
-------------
.. _mame-scommandline-centerh:
**-[no]centerh**
Center horizontally within the view area. Default is ON (**-centerh**).
.. _mame-scommandline-centerv:
**-[no]centerv**
Center vertically within the view area. Default is ON (**-centerv**).
Video Soft-Specific Options
---------------------------
.. _mame-scommandline-scalemode:
**-scalemode**
Scale mode: none, async, yv12, yuy2, yv12x2, yuy2x2 (**-video soft** only).
Default is *none*.
SDL Keyboard Mapping
--------------------
.. _mame-scommandline-keymap:
**-keymap**
Enable keymap. Default is OFF (**-nokeymap**)
.. _mame-scommandline-keymapfile:
**-keymap_file** *<file>*
Keymap file name. Default is ``keymap.dat``.
SDL Input Options
--------------------
.. _mame-scommandline-enabletouch:
**-enable_touch**
Enable support for touch input. If this option is switched off, mouse input
simulated from touch devices will be used instead. Default is OFF
(**-noenable_touch**)
.. _mame-scommandline-sixaxis:
**-sixaxis**
Use special handling for PlayStation 3 SixAxis controllers. May cause
undesirable behaviour with other controllers. Only affects the ``sdljoy``
joystick provider. Default is OFF (**-nosixaxis**)
SDL Lightgun Mapping
--------------------
.. _mame-scommandline-lightgunindex:
|
| **-lightgun_index1** *<name>*
| **-lightgun_index2** *<name>*
| ...
| **-lightgun_index8** *<name>*
|
Device name or ID mapped to a given lightgun slot.
SDL Low-level Driver Options
----------------------------
.. _mame-scommandline-videodriver:
**-videodriver** *<driver>*
SDL video driver to use ('x11', 'directfb', ... or '*auto*' for SDL default)
.. _mame-scommandline-audiodriver:
**-audiodriver** *<driver>*
SDL audio driver to use ('alsa', 'arts', ... or '*auto*' for SDL default)
.. _mame-scommandline-gllib:
**-gl_lib** *<driver>*
Alternative **libGL.so** to use; '*auto*' for system default