Sprinter/mame
2
0
Fork 0
mirror of https://github.com/holub/mame synced 2025-06-07 13:23:50 +03:00
Code Issues Actions 4 Packages Projects Releases Wiki Activity

layout doc: correction and add inputraw (this one actually does work the way inputmask was documented before) (nw)

Browse Source
This commit is contained in:
hap 2019-03-24 23:30:02 +01:00
parent 465f5d42aa
commit cdde287597
1 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/source/techspecs/layout_files.rst
View File

@ -768,12 +768,15 @@ how digital displays may be connected to emulated outputs::
If an element instantiating a layout element has ``inputtag`` and ``inputmask`` If an element instantiating a layout element has ``inputtag`` and ``inputmask``
attributes but lacks a ``name`` attribute, it will take its state from the value attributes but lacks a ``name`` attribute, it will take its state from the value
of the corresponding I/O port, masked with the ``inputmask`` value, and shifted of the corresponding I/O port, masked with the ``inputmask`` value and XORed
to the right so that the least significant one bit of the mask aligns with the with the I/O port default field value. The latter is useful for inputs that are
least significant bit of the value (for example a mask of 0x05 will result in no active-low. If the result is non-zero, the state is 1, otherwise it's 0. This
shift, while a mask of 0xb0 will result in the value being shifted four bits to is often used to allow clickable buttons and toggle switches to provide visible
the right). This is often used to allow clickable buttons and toggle switches feedback. By using ``inputraw="1"``, it's possible to obtain the raw data from
to provide visible feedback. the I/O port, masked with the ``inputmask`` and shifted to the right so that the
least significant one bit of the mask aligns with the least significant bit of
the value (for example a mask of 0x05 will result in no shift, while a mask of
0xb0 will result in the value being shifted four bits to the right).
When handling mouse input, MAME treats all layout elements as being rectangular, When handling mouse input, MAME treats all layout elements as being rectangular,
and only activates the frontmost element whose area includes the location of the and only activates the frontmost element whose area includes the location of the