From 520ed5e44b49f80ec38bb812d8477e2b8a607cfc Mon Sep 17 00:00:00 2001 From: Vas Crabb Date: Thu, 18 Apr 2024 05:59:03 +1000 Subject: -ui/ui.cpp, ui/videoopt.cpp: Made pointer activity timeout configurable. -midway/wmg.cpp: Use a memory bank for NVRAM; also got rid of a really pointless trampoline function. --- docs/source/advanced/ctrlr_config.rst | 46 ++++++++++++++++++++++++++++++++++- docs/source/conf.py | 4 +-- 2 files changed, 47 insertions(+), 3 deletions(-) (limited to 'docs/source') diff --git a/docs/source/advanced/ctrlr_config.rst b/docs/source/advanced/ctrlr_config.rst index 7fb531b604c..1f19924e741 100644 --- a/docs/source/advanced/ctrlr_config.rst +++ b/docs/source/advanced/ctrlr_config.rst @@ -71,8 +71,10 @@ with a ``version`` attribute specifying the configuration format version (currently ``10`` – MAME will not load a file using a different version). The ``mameconfig`` element contains one or more ``system`` elements, each of which has a ``name`` attribute specifying the system(s) it applies to. Each -``system`` element contains an ``input`` element which holds the actual +``system`` element may contain an ``input`` element which holds the actual ``remap`` and ``port`` configuration elements, which will be described later. +Each ``system`` element may also contain a ``pointer_input`` element to set +pointer input options for systems with interactive artwork. When launching an emulated system, MAME will apply configuration from ``system`` elements where the value of the ``name`` attribute meets one of the following @@ -261,3 +263,45 @@ MAME applies ``mapdevice`` elements found inside the first applicable ``system`` element only. To avoid confusion, it’s simplest to place the ``system`` element applying to all systems (``name`` attribute set to ``default``) first in the file, and use it to assign input device numbers. + + +.. _ctrlrcfg-pointers: + +Setting pointer input options +----------------------------- + +A ``pointer_input`` element may contain ``target`` elements to set pointer input +options for each output screen or window. Each ``target`` element must have an +``index`` attribute containing the zero-based index of the screen to which it +applies. + +Each ``target`` element may have an ``activity_timeout`` attribute to set the +time after which a mouse pointer that has not moved and has no buttons pressed +will be considered inactive. The value is specified in seconds, and must be in +the range of 0.1 seconds to 10 seconds, inclusive. + +Each ``target`` element may have a ``hide_inactive`` element to set whether +inactive pointers may be hidden. If the value is ``0`` (zero), inactive +pointers will not be hidden. If the value is ``1``, inactive pointers may be +hidden, but layout views can still specify that inactive pointers should not be +hidden. + +Here’s an example demonstrating the use of this feature: + +.. code-block:: XML + + + + + + + + + + + + +For all systems, pointers over the first output screen or window will be +considered inactive after not moving for 1.5 seconds with no buttons pressed. +For systems defined in ``intellec4.cpp``, inactive pointers over the first +window will not be hidden. diff --git a/docs/source/conf.py b/docs/source/conf.py index 3ab96db14b5..4f5f06b3e52 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -63,9 +63,9 @@ copyright = u'1997-2024, MAMEdev and contributors' # built documents. # # The short X.Y version. -version = '0.264' +version = '0.265' # The full version, including alpha/beta/rc tags. -release = '0.264' +release = '0.265' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. -- cgit v1.2.3-70-g09d2