diff options
author | 2022-09-02 08:55:16 +1000 | |
---|---|---|
committer | 2022-09-02 08:55:16 +1000 | |
commit | 051c380fd14040c83a0d5b919e6289e70fef9df8 (patch) | |
tree | e247a309f4d1c66c07803c02d67ac89837211bd1 /docs/source/advanced/ctrlr_config.rst | |
parent | 67f129e31518a50a801413f732991972d2c3538a (diff) |
Patched up some gaps in functionality and fixed some bugs.
ui: Added some missing functionality:
* Added an option to copy input device IDs to the relevant menus.
* Added an item for setting the software lists files path (-hashpath) to
the folder setup menu.
* Allow pasting text from clipboard in most places that allow typing
(searching, entering filenames, entering barcodes).
* Changed the software selection menu heading to be a bit less
misleading.
* Made barcode menu less eager to rebuild itself unnecessarily, and
removed some confusing and apparently pointless code.
Exposed more Lua bindings:
* Added low-level palette objects.
* Added indexed bitmap types.
* Added a bitmap method for extracting pixels from a rectangular area as a
packed binary string.
* Changed screen device pixels method to return width and height in
addition to the pixels.
osd: Added some functionality and cleaned up a little:
* Added a function for copying text to the clipboard.
* Moved function for converting Windows error codes to standard error
conditions to winutil.cpp so it can be used from more places.
* Removed duplicate declaration of osd_get_clipboard_text and made the
function noexcept (including fixing implementations).
* Made macOS implementation of osd_get_clipboard_text skip the encoding
conversion if it finds UTF-8 text first.
* Changed the default -uimodekey setting so it doesn't lose the "not
shift" that stops the default from interfering with UI paste.
Various bug fixes:
* util/unicode.cpp: Fixed the version of utf8_from_uchar that returns
std::string blowing up on invalid codepoints.
* util/bitmap.h: Fixed wrapping constructors for indexed bitmaps taking
the wrong parameter type (nothing was using them before).
* util/bitmap.cpp: Fixed potential use-after-free issues with bitmap
palettes.
* emu/input.cpp, emu/inputdev.cpp: Log 1-based device numbers, matching
what's shown in the internal UI and used in tokens in CFG files.
* emu/emumem.cpp: Added the bank tag to a fatal error message where it
was missing.
docs: Reworked and expanded documentation on configuring stable
controller IDs.
For translators, the changes are quite minor:
* There's a menu item for copying a device ID to the clipboard, and
associated success/failure messages.
* There's the menu item for setting the software list file search path.
* One of the lines in the software selection menu heading has changes as
it could be interpreted as implying it showed a software list name.
Diffstat (limited to 'docs/source/advanced/ctrlr_config.rst')
-rw-r--r-- | docs/source/advanced/ctrlr_config.rst | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/source/advanced/ctrlr_config.rst b/docs/source/advanced/ctrlr_config.rst index 6fdeddc8a8a..9e284f7f945 100644 --- a/docs/source/advanced/ctrlr_config.rst +++ b/docs/source/advanced/ctrlr_config.rst @@ -228,3 +228,34 @@ Here’s an example that overrides defaults for 280-ZZZAP: This sets the controls to steer left and right to the K and J keys, respectively, and disables the toggle setting for the gear shift input. + + +.. _ctrlrcfg-mapdevice: + +Assigning input device numbers +------------------------------ + +Use ``mapdevice`` elements with ``device`` and ``controller`` attributes to +assign stable numbers to input devices. Note that all devices explicitly +configured in this way must be connected when MAME starts for this to work as +expected. + +Set the ``device`` attribute to the device ID of the input device, and set the +``controller`` attribute to the desired input device token (device type and +number). + +Here’s an example numbering two light guns and two XInput game controllers: + +.. code-block:: XML + + <system name="default"> + <input> + <mapdevice device="VID_D209&PID_1601" controller="GUNCODE_1" /> + <mapdevice device="VID_D209&PID_1602" controller="GUNCODE_2" /> + <mapdevice device="XInput Player 1" controller="JOYCODE_1" /> + <mapdevice device="XInput Player 2" controller="JOYCODE_2" /> + </input> + </system> + +MAME applies ``mapdevice`` elements found inside any applicable ``system`` +element. |