mame/docs/source/plugins/timer.rst
Vas Crabb 07e55935cf plugins: Rewrote timer plugin fixing multiple issues.
Added emulated time recording as well as wall clock time.

Fixed recording time for multiple software items per system.  An
incorrect constraint on the database table meant that time was only
being recorded for a single software item per system.

Detect the "empty" driver so the time spent at the selection menu isn't
recorded (you'd get multiple entries for this due to the way options
leak when returning to the system selection menu).

Included schema migration code to update existing timer plugin
databases.  Also replaced some unnecessary floating point code with
integer maths, added log messages, and made the plugin unload unload its
database access code during emulation.

Changed other plugins' use of paths with trailing slashes as this causes
stat to fail on Windows.
2021-11-06 05:20:59 +11:00

22 lines
1 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-timer:
Game Play Timer Plugin
======================
The timer plugin records the total time spent emulating each combination of a
system and a software list item, as well as the number of times each combination
has been launched. To see the statistics, bring up the main menu (press **Tab**
during emulation by default), choose **Plugin Options**, and then choose
**Timer**.
This plugin records wall clock time (the real time duration elapsed while
emulation is running, according to the host OS) as well as emulated time. The
elapsed wall clock time may be shorter than the elapsed emulated time if you
turn off throttling or use MAMEs “fast forward” feature, or it may be longer
than the elapsed emulated time if you pause the emulation of if the emulation is
too demanding to run at full speed.
The statistics are stored in the file **timer.db** in the **timer** folder
inside your plugin data folder (see the
:ref:`homepath option <mame-commandline-homepath>`). The file is a SQLite3
database.