mame/docs/source/plugins/data.rst
Vas Crabb d64ea5331b
-frontend: Refactored menu event handling and fixed a number of issues. (#8777)
* Moved common code for drawing about box, info viewer, and other text box menus to a base class; removed the last of the info viewer logic and the multi-line item hack from the base menu class.
* Added previous/next group navigation for general inputs and plugin input selection menus.
* Moved message catalog logic to lib/util, allowing osd and emu to use localised messages.
* Made the base menu class use the UI manager’s feature for holding session state rather than a static map and mutex.
* Improved menu event handling model, and fixed many issues, particularly with menus behaving badly when hidden/shown.
* Added better support for menus that don’t participate in the usual menu stack, like the menuless sliders and the save/load state menus.
* Made a number of menus refresh state when being shown after being hidden (fixes MT08121 among other issues).
* Fixed indication of mounted slot option in the slot option details menu.
* Improved appearance of background menus when emulation isn't running - draw all menus in the stack, and darken the background menus to make the edges of the active menu clearer.
* Fixed locale issues in -listxml.

-debugger: Made GUI debuggers more uniform.
* Added new memory view features to Win32 debugger.
* Fixed spelling of hexadecimal in Cocoa debugger and added decimal address option.
* Fixed duplicate keyboard shortcut in Cocoa debugger (Shift-Cmd-D was both new device window and 64-bit float format).
* Made keyboard shortcuts slightly more consistent across debuggers.

-plugins: Moved input selection menu and sequence polling code to a common library.  Fixed the issue that prevented keyboard inputs being mapped with -steadykey on.

-docs: Started adding some documentation for MAME's internal UI, and updated the list of example front-ends.

-Regenerated message catalog sources.  For translators, the new strings are mostly:
* The names of the inputs provided by the OS-dependent layer for things like fullscreen and video features. These show up in the user interface inputs menu.
* The names for automatically generated views. These show up in the video options menu - test with a system with a lot of screens to see more variants.
* The input macro plugin UI.
* A few format strings for analog input assignments.
* A few strings for the about box header.
2021-10-31 12:31:16 +11:00

59 lines
2.4 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

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.

.. _plugins-data:
Data Plugin
===========
The data plugin loads information from various external support files so it can
be displayed in MAME. If the plugin is enabled, info is show in the **Infos**
tab of the right-hand pane on the system and software selection menus. The info
viewer can be shown by clicking the toolbar button on the system and software
selection menus, or by choosing **External DAT View** from the main menu during
emulation (this menu item will not appear if the data plugin is not enabled, or
if no information is available for the emulated system).
To set the folders where the data plugin looks for supported files, choose
**Configure Options** on the system selection menu, then choose
**Configure Directories**, and then choose **DATs**. You can also set the
``historypath`` option in your **ui.ini** file.
Loading large data files like **history.xml** can take quite a while, so please
be patient the first time you start MAME after updating or adding new data
files.
The following files are supported:
history.xml
From `Gaming-History <https://www.arcade-history.com/>`_ (formerly
Arcade-History)
mameinfo.dat
From `MASHs MAMEINFO <https://mameinfo.mameworld.info/>`_
messinfo.dat
From `progetto-SNAPS MESSINFO.dat
<https://www.progettosnaps.net/messinfo/>`_
gameinit.dat
From `progetto-SNAPS GameInit.dat
<https://www.progettosnaps.net/gameinit/>`_
command.dat
from `progetto-SNAPS Command.dat
<https://www.progettosnaps.net/command/>`_
score3.htm
`Top Scores <http://replay.marpirc.net/txt/scores3.htm>`_ from
the `MAME Action Replay Page <http://replay.marpirc.net/>`_
Japanese mameinfo.dat and command.dat
From `MAME E2J <https://e2j.net/downloads/>`_
sysinfo.dat
From the defunct Progetto EMMA site
story.dat
From the defunct MAMESCORE site
If you install `hi2txt <https://greatstoneex.github.io/hi2txt-doc/>`_, the data
plugin can also show high scores from non-volatile memory or saved by the
:ref:`hiscore support plugin <plugins-hiscore>` for supported games.
Note that you can only use a single file of each type at a time. You cannot,
for example, use the English and Japanese **mameinfo.dat** files simultaneously.
The data plugin creates a **history.db** file in the first configured DATs
folder. This file stores the information from the support files in a format
suitable for rapid loading. It uses the SQLite3 database format.