mame/docs/source
Vas Crabb c38a3395e9 Make layout format more flexible:
* There is no longer a concept of "layers" - there are only screens and elements.
* Elements are now instantiated with <element ref="...">
* Screens and elements can have explicit blending mode specified with blend="..."
* Default blending mode for screens is "add" and default for other elements is "alpha"
* Other supported modes are "none" and "multiply"
* This removes the options to enable/disable layers individually - use views instead
* Legacy layouts can still be loaded, and support won't be removed for at least a year

The current artwork model is over-stretched.  It's based on a Space
Invaders cabinet model, and isn't applicable to a lot of the systems
MAME emulates now.  The fact that MAME has to switch to an "alternate"
mode to deal with games like Golly! Ghost! without requiring pre-matted
bitmaps shows that the Space Invaders model wasn't even adequate for
general arcade use.  It shows in that for a lot of the systems that
heavily depend on artwork, people just seem to randomly choose layers
for elements until they get something that works.  Also, the fact that
MAME will switch to an alternate (Golly! Ghost!) mode depending on the
combination of elements is a trap for people learning to make artwork.

There are cases that the current approach of implying the blending mode
from the layer doesn't work with.  Examples include LEDs behind
diffusers (requires additive blending for layout elements), and mutliple
stacked LCD panels (requires RGB multiplication for screens).

For configurability, it's now a lot easier to make multiple views using
groups.  For example, if you want to make it possible to hide the
control panel section of your layout, you can put the control panel
elements in a group and create views with and without it.

I will gradually migrate the internal artwork to use the new approach.
I have an XSLT stylesheet that helps with this, but I'm not comfortable
adding it because it isn't a complete solution and it still requires
manul steps.

I wanted to get the re-worked pointer handling done sooner so I could
push them both at the same time, but unfortunately various things have
prevented me from progressing as quickly as I wanted to.  Sorry guys,
that stuff's going to have to wait.
2019-07-06 00:23:20 +10:00
..
_ext Added documentation to main tree (nw) 2016-08-24 15:16:43 +02:00
advanced Overhaul to advanced gun instructions (nw) 2019-05-28 22:24:26 -07:00
commandline Make layout format more flexible: 2019-07-06 00:23:20 +10:00
debugger allow repeating elements and groups - useful if you need e.g. a lot of numbered labels, but it limits complay.py's ability to check for invalid references as it can't evaluate expressions (nw) 2018-07-22 09:52:50 +10:00
images (nw) Clean up the mess on master 2019-03-26 11:13:37 +11:00
initialsetup (nw) Fedora users need this now that X11 XInput is enabled by default - no clue about other Linuxes 2019-04-26 01:55:17 +10:00
techspecs Make layout format more flexible: 2019-07-06 00:23:20 +10:00
tools Spelling fix in castool documentation (nw) 2018-03-06 13:37:56 +00:00
usingmame Clean up phrasing a bit on input from MG (nw) 2018-10-19 17:02:01 -07:00
__init__.py Added documentation to main tree (nw) 2016-08-24 15:16:43 +02:00
conf.py (nw) Clean up the mess on master 2019-03-26 11:13:37 +11:00
index.rst (nw) Clean up the mess on master 2019-03-26 11:13:37 +11:00
license.rst (nw) Clean up the mess on master 2019-03-26 11:13:37 +11:00
security.rst srcclean again (nw) 2016-11-30 07:04:04 +11:00
whatis.rst (nw) Clean up the mess on master 2019-03-26 11:13:37 +11:00