From 9ea6512671ada8d4d16fa9a93c35b2244c1d79f3 Mon Sep 17 00:00:00 2001 From: Vas Crabb Date: Wed, 28 Oct 2020 14:58:52 +1100 Subject: [PATCH] docs: Add links to some internal layouts that demonstrate various features, and udpate required MSYS64 packages for using lld. --- docs/source/initialsetup/compilingmame.rst | 5 +-- docs/source/techspecs/layout_files.rst | 39 ++++++++++++++++++++++ 2 files changed, 42 insertions(+), 2 deletions(-) diff --git a/docs/source/initialsetup/compilingmame.rst b/docs/source/initialsetup/compilingmame.rst index 09b45d2869a..e9e931238de 100644 --- a/docs/source/initialsetup/compilingmame.rst +++ b/docs/source/initialsetup/compilingmame.rst @@ -101,8 +101,9 @@ with MSYS2 and the **pacman** package manager. ``mingw-w64-i686-python``. * For debugging you may want to install ``gdb``. * To link using the LLVM linker (generally much faster than the GNU linker), - you'll need ``mingw-w64-x86_64-lld`` for 64-bit builds, or - ``mingw-w64-i686-lld`` for 32-bit builds. + you'll need ``mingw-w64-x86_64-lld`` and ``mingw-w64-x86_64-libc++`` for + 64-bit builds, or ``mingw-w64-i686-lld`` and ``mingw-w64-i686-libc++`` for + 32-bit builds. * To build against the portable SDL interfaces, you'll need ``mingw-w64-x86_64-SDL2`` and ``mingw-w64-x86_64-SDL2_ttf`` for 64-bit builds, or ``mingw-w64-i686-SDL2`` and ``mingw-w64-i686-SDL2_ttf`` for 32-bit builds. diff --git a/docs/source/techspecs/layout_files.rst b/docs/source/techspecs/layout_files.rst index 7bb69678d8c..a3de7d66390 100644 --- a/docs/source/techspecs/layout_files.rst +++ b/docs/source/techspecs/layout_files.rst @@ -1365,3 +1365,42 @@ To check a layout file for common errors, run the script with the path to the file no check and no output file name or base variable name. For example: **python scripts/build/complay.py artwork/dino/default.lay** + + +.. _layout-examples: + +Example layout files +-------------------- + +These layout files demonstrate various artwork system features. They are all +internal layouts included in MAME. + +`sstrangr.lay `_ + A simple case of using translucent colour overlays to visually separate and + highlight elements on a black and white screen. +`seawolf.lay `_ + This system uses lamps for key gameplay elements. Blending modes are used + for the translucent colour overlay placed over the monitor, and the lamps + reflected in front of the monitor. Also uses collections to allow parts of + the layout to be disabled selectively. +`armora.lay `_ + This game’s monitor is viewed directly through a translucent colour overlay + rather than being reflected from inside the cabinet. This means the overlay + reflects ambient light as well as affecting the colour of the video image. +`tranz330.lay `_ + A multi-segment alphanumeric display and keypad. The keys are clickable, + and provide visual feedback when pressed. +`esq2by16.lay `_ + Builds up a multi-line dot matrix character display. Repeats are used to + avoid repetition for the rows in a character, characters in a line, and + lines in a page. Group colors allow a single element to be used for all + four display colours. +`cgang.lay `_ + Animates the position of element items to simulate an electromechanical + shooting gallery game. Also demonstrates effective use of components to + build up complex graphics. +`unkeinv.lay `_ + Shows the position of a slider control with LEDs on it. +`md6802.lay `_ + Effectively using groups as a procedural programming language to build up an + image of a trainer board.