Documentation update.

CHANGELOG.md

@@ -123,13 +123,20 @@ v1.2 maintenance release.
 
 ### Detailed list of changes
 
-* Added fallback for high resolution marquee/wheel image for ScreenScraper if no regular wheel image was found
+* ScreenScraper searches in automatic mode are now faster and much more accurate
-* Added the SwanStation RetroArch core as an alternative emulator
+* Added fallback to high resolution marquee/wheel images for ScreenScraper if no regular wheel image was found
+* Added support for the Nintendo SFC (Super Famicom) game system
+* Added the SwanStation RetroArch core as an alternative emulator for the psx system
+* Added the a5200 RetroArch core for the atari5200 system and set it as default, with atari800 as the alternative
+* Added the .chd file extension to the ps2 system
+* Added the .dosz file extension to the dos and pc systems
+* Emulator Flatpaks can now be installed to the home directory on Debian
 * Increased the default VRAM limit from 256 MiB to 512 MiB on the Steam Deck
 
 ### Bug fixes
 
-* Fixed a font loading crash caused by an insufficient font texture size
+* A crash could occur under some circumstances due to an insufficient font texture size
+* The systems were not always sorted correctly
 * The help system was not properly updated after results were returned by the scraper
 
 ## Version 1.2.1

THEMES-LEGACY.md

@@ -2,7 +2,7 @@
 
 **This document covers the creation of legacy themes only, which is a theme structure that is backward compatible with RetroPie EmulationStation. As ES-DE v2.0 and later has a new theme engine with much improved theming capabilities, this document is mostly intended for historical reference. For creating or porting themes to ES-DE the documentation in [THEMES.md](THEMES.md) should be used instead.**
 
-If creating theme sets specifically for ES-DE, please add `-DE` to the theme name, as in `rbsimple-DE`. Because the ES-DE theme support has already deviated somehow from the RetroPie EmulationStation fork and will continue to deviate further in the future, the theme set will likely not be backwards compatible. It would be confusing and annoying for a user that downloads and attempts to use an ES-DE theme set in another EmulationStation fork only to get crashes, error messages or corrupted graphics. At least the -DE extension is a visual indicator that it's an ES-DE specific theme set.
+In general ES-DE is backward compatible with RetroPie theme sets with the notable exception of the _Grid_ view style which is not supported. Themes with grid view styles included will still load correctly, but you can't actually use this view style.
 
 Table of contents:
 
@@ -331,11 +331,10 @@ Below are the default zIndex values per element type:
 * `carousel name="systemcarousel"` - 40
 * `text name="systemInfo"` - 50
 
-#### basic, detailed, video, grid
+#### basic, detailed, video
 * `image name="background"` - 0
 * Extra Elements `extra="true"` - 10
 * `textlist name="gamelist"` - 20
-* `imagegrid name="gamegrid"` - 20
 * Media
     * `image name="md_image"` - 30
     * `video name="md_video"` - 30
@@ -546,62 +545,6 @@ or to specify only a portion of the value of a theme property:
         * `text name="md_name"` - ALL
             - The "name" metadata (the game name). Unlike the others metadata fields, the name is positioned offscreen by default
 
-
-#### grid
-* `helpsystem name="help"` - ALL
-    - The help system style for this view.
-* `image name="background"` - ALL
-    - This is a background image that exists for convenience. It goes from (0, 0) to (1, 1).
-* `text name="logoText"` - ALL
-    - Displays the name of the system.  Only present if no "logo" image is specified.  Displayed at the top of the screen, centered by default.
-* `image name="logo"` - ALL
-    - A header image.  If a non-empty `path` is specified, `text name="logoText"` will be hidden and this image will be, by default, displayed roughly in its place.
-* `imagegrid name="gamegrid"` - ALL
-    - The gamegrid. The number of tile displayed is controlled by its size, margin and the default tile max size.
-* `gridtile name="default"` - ALL
-    - Note that many of the default gridtile parameters change the selected gridtile parameters if they are not explicitly set by the theme. For example, changing the background image of the default gridtile also change the background image of the selected gridtile. Refer to the gridtile documentation for more informations.
-* `gridtile name="selected"` - ALL
-    - See default gridtile description right above.
-* `text name="gamelistInfo"` - ALL
-    - Displays the game count (all games as well as favorites), any applied filters, and a folder icon if a folder has been entered. If this text is left aligned, the folder icon will be placed to the right of the other information, and if it's right aligned, the folder icon will be placed to the left. Left aligned by default.
-
-- Metadata
-    - Labels
-        * `text name="md_lbl_rating"` - ALL
-        * `text name="md_lbl_releasedate"` - ALL
-        * `text name="md_lbl_developer"` - ALL
-        * `text name="md_lbl_publisher"` - ALL
-        * `text name="md_lbl_genre"` - ALL
-        * `text name="md_lbl_players"` - ALL
-        * `text name="md_lbl_lastplayed"` - ALL
-        * `text name="md_lbl_playcount"` - ALL
-
-    * Values
-        - _All values will follow to the right of their labels if a position isn't specified._
-        * `rating name="md_rating"` - ALL
-            - The "rating" metadata.
-        * `datetime name="md_releasedate"` - ALL
-            - The "releasedate" metadata.
-        * `text name="md_developer"` - ALL
-            - The "developer" metadata.
-        * `text name="md_publisher"` - ALL
-            - The "publisher" metadata.
-        * `text name="md_genre"` - ALL
-            - The "genre" metadata.
-        * `text name="md_players"` - ALL
-            - The "players" metadata (number of players the game supports).
-        * `badges name="md_badges"` - ALL
-            - The "badges" metadata. Displayed as a group of badges that indicate metadata such as favorites and completed games.
-        * `datetime name="md_lastplayed"` - ALL
-            - The "lastplayed" metadata.  Displayed as a string representing the time relative to "now" (e.g. "3 hours ago").
-        * `text name="md_playcount"` - ALL
-            - The "playcount" metadata (number of times the game has been played).
-        * `text name="md_description"` - POSITION | SIZE | FONT_PATH | FONT_SIZE | COLOR | Z_INDEX
-            - Text is the "desc" metadata.  If no `pos`/`size` is specified, will move and resize to fit under the lowest label and reach to the bottom of the screen.
-        * `text name="md_name"` - ALL
-            - The "name" metadata (the game name). Unlike the others metadata fields, the name is positioned offscreen by default
-
-
 ### Types of properties
 
 * NORMALIZED_PAIR - two decimals, in the range [0..1], delimited by a space.  For example, `0.25 0.5`.  Most commonly used for position (x and y coordinates) and size (width and height).
@@ -649,54 +592,6 @@ Can be created as an extra.
 * `zIndex` - type: FLOAT.
     - z-index value for component.  Components will be rendered in order of z-index value from low to high.
 
-#### imagegrid
-
-* `pos` - type: NORMALIZED_PAIR.
-* `size` - type: NORMALIZED_PAIR.
-    - The size of the grid. Take care the selected tile can go out of the grid size, so don't position the grid too close to another element or the screen border.
-* `margin` - type: NORMALIZED_PAIR. Margin between tiles.
-* `padding` - type: NORMALIZED_RECT.
-    - NEW : Padding for displaying tiles.
-* `autoLayout` - type: NORMALIZED_PAIR.
-    - NEW : Number of column and rows in the grid (integer values).
-* `autoLayoutSelectedZoom` - type: FLOAT.
-    - NEW : Zoom factor to apply when a tile is selected.
-* `gameImage` - type: PATH.
-    - The default image used for games which doesn't have an image.
-* `folderImage` - type: PATH.
-    - The default image used for folders which doesn't have an image.
-* `imageSource` - type: STRING.
-    - Selects the image to display. `thumbnail` by default, can also be set to `image`, `miximage`, `screenshot`, `cover`, `marquee` or `3dbox`. If selecting `image`, the media type `miximage` will be tried first, with fallback to `screenshot` and then `cover`.
-* `scrollDirection` - type: STRING.
-    - `vertical` by default, can also be set to `horizontal`. Not that in `horizontal` mod, the tiles are ordered from top to bottom, then from left to right.
-* `centerSelection` - type: BOOLEAN.
-    - `false` by default, when `true` the selected tile will be locked to the center of the grid.
-* `scrollLoop` - type: BOOLEAN.
-    - `false` by default, when `true` the grid will seamlessly loop around when scrolling reaches the end of the list.  Only works when `centerSelection` is `true`.
-* `animate` - type : BOOLEAN.
-    - `true` by default, when  `false` the grid scrolling will not be animated.
-* `zIndex` - type: FLOAT.
-    - z-index value for component.  Components will be rendered in order of z-index value from low to high.
-
-#### gridtile
-
-* `size` - type: NORMALIZED_PAIR.
-    - The size of the default gridtile is used to calculate how many tiles can fit in the imagegrid. If not explicitly set, the size of the selected gridtile is equal the size of the default gridtile * 1.2
-* `padding` - type: NORMALIZED_PAIR.
-    - The padding around the gridtile content. Default `16 16`. If not explicitly set, the selected tile padding will be equal to the default tile padding.
-* `imageColor` - type: COLOR.
-    - The default tile image color and selected tile image color have no influence on each others.
-* `backgroundImage` - type: PATH.
-    - If not explicitly set, the selected tile background image will be the same as the default tile background image.
-* `backgroundCornerSize` - type: NORMALIZED_PAIR.
-    - The corner size of the ninepatch used for the tile background. Default is `16 16`.
-* `backgroundColor` - type: COLOR.
-    - A shortcut to define both the center color and edge color at the same time. The default tile background color and selected tile background color have no influence on each others.
-* `backgroundCenterColor` - type: COLOR.
-    - Set the color of the center part of the ninepatch. The default tile background center color and selected tile background center color have no influence on each others.
-* `backgroundEdgeColor` - type: COLOR.
-    - Set the color of the edge parts of the ninepatch. The default tile background edge color and selected tile background edge color have no influence on each others.
-
 #### video
 
 * `pos` - type: NORMALIZED_PAIR.

USERGUIDE-DEV.md

@@ -581,7 +581,7 @@ It's highly recommended to use filenames that are corresponding to the full name
 
 **Note:** Symlinks are supported for both ROM directories and individual game files, but make sure to not symlink between files within the same system directory or there may be undefined application behavior when scraping, launching games etc.
 
-The default game folder is ~/ROMs. On Unix this defaults to /home/\<username\>/ROMs, on macOS /Users/\<username\>/ROMs and on Windows C:\Users\\<username\>\ROMs\. If the --home command line option was used to start ES-DE, the tilde `~` symbol will resolve to whatever directory was passed as an argument to this option.
+The default game folder is ~/ROMs. On Unix this defaults to /home/\<username\>/ROMs, on macOS /Users/\<username\>/ROMs and on Windows C:\Users\\<username\>\ROMs\. If the --home command line option was used to start ES-DE, the tilde symbol will resolve to whatever directory was passed as an argument to this option.
 
 Assuming the default ROM directory is used, we need to create a subdirectory corresponding to the \<path\> tag in es_systems.xml, for this example it's `nes`.
 
@@ -686,6 +686,32 @@ For Windows, ES-DE will look for _yuzu.exe_ in the system Path as well as in the
 
 Apart from the potential difficulty in locating the emulator binary, there are some special configuration steps required for the emulator, refer to the Yuzu website for more information about this.
 
+#### Nintendo Wii U
+
+This section is specific to Windows as Cemu is currently only supported on this operating system.
+
+Cemu works a bit different compared to most other emulators, with games stored in an unpacked format. The content of each game is divided into the three directories _code, content_ and _meta_.
+
+The first step is to prepare the target directory in the `wiiu` ROMs directory, for this example we'll go for the game _Super Mario 3D World_. So simply create a directory with this name inside the wiiu folder. It should look something like the following:
+```
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\
+```
+
+The next step is done inside the emulator user interface. You should install the game, any updates as well as optional DLCs to the Cemu NAND. After the installation is completed, right click on the game and choose _Game directory_. An Explorer window should now open showing the content of the game. Here's the game directory for our example:
+```
+C:\Games\cemu\mlc01\usr\title\00050000\10145d00\code
+```
+
+Go up one level and copy the _code, content_ and _meta_ directories and paste them into the C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\ directory. It should now look something like the following:
+
+```
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\code
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\content
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\meta
+```
+
+Starting ES-DE should now show the _Super Mario 3D World_ entry for the Wii U system. The actual game file with the extension .rpx is stored inside the _code_ directory, and does not normally match the name of the game. For this example it's named `RedCarpet.rpx`. When scraping the .rpx file you therefore need to refine the search and manually enter the game name. ES-DE fully supports scraping of directories, so you can scrape the _Super Mario 3D World_ folder as well.
+
 #### Sony PlayStation 3
 
 The RPCS3 emulator requires a bit of special setup.
@@ -2054,7 +2080,7 @@ All emulators are RetroArch cores unless marked as **(Standalone**)
 | arcade                | Arcade                                         | MAME - Current                    | MAME 2000,<br>MAME 2003-Plus,<br>MAME 2010,<br>FinalBurn Neo,<br>FB Alpha 2012,<br>MAME **(Standalone)** [UW*] | Depends      | Single archive file following MAME name standard in root folder |
 | astrocade             | Bally Astrocade                                | _Placeholder_                     |                                   |              |                                      |
 | atari2600             | Atari 2600                                     | Stella                            | Stella 2014                       | No           | Single archive or ROM file in root folder |
-| atari5200             | Atari 5200                                     | Atari800                          |                                   |              |                                      |
+| atari5200             | Atari 5200                                     | a5200                             | Atari800                          |              |                                      |
 | atari7800             | Atari 7800 ProSystem                           | ProSystem                         |                                   |              |                                      |
 | atari800              | Atari 800                                      | Atari800                          |                                   |              |                                      |
 | atarijaguar           | Atari Jaguar                                   | Virtual Jaguar                    |                                   |              |                                      |
@@ -2150,6 +2176,7 @@ All emulators are RetroArch cores unless marked as **(Standalone**)
 | sega32xjp             | Sega Super 32X [Japan]                         | PicoDrive                         |                                   | No           | Single archive or ROM file in root folder |
 | sega32xna             | Sega Genesis 32X [North America]               | PicoDrive                         |                                   | No           | Single archive or ROM file in root folder |
 | segacd                | Sega CD                                        | Genesis Plus GX                   | Genesis Plus GX Wide,<br>PicoDrive |              |                                      |
+| sfc                   | Nintendo SFC (Super Famicom)                   | Snes9x - Current                  | Snes9x 2010,<br>bsnes,<br>bsnes-mercury Accuracy,<br>Beetle Supafaust [UW],<br>Mesen-S | No           | Single archive or ROM file in root folder |
 | sg-1000               | Sega SG-1000                                   | Gearsystem                        | Genesis Plus GX,<br>Genesis Plus GX Wide,<br>blueMSX |              |                                      |
 | snes                  | Nintendo SNES (Super Nintendo)                 | Snes9x - Current                  | Snes9x 2010,<br>bsnes,<br>bsnes-mercury Accuracy,<br>Beetle Supafaust [UW],<br>Mesen-S | No           | Single archive or ROM file in root folder |
 | snesna                | Nintendo SNES (Super Nintendo) [North America] | Snes9x - Current                  | Snes9x 2010,<br>bsnes,<br>bsnes-mercury Accuracy,<br>Beetle Supafaust [UW],<br>Mesen-S | No           | Single archive or ROM file in root folder |

USERGUIDE.md

@@ -597,7 +597,7 @@ It's highly recommended to use filenames that are corresponding to the full name
 
 **Note:** Symlinks are supported for both ROM directories and individual game files, but make sure to not symlink between files within the same system directory or there may be undefined application behavior when scraping, launching games etc.
 
-The default game folder is ~/ROMs. On Unix this defaults to /home/\<username\>/ROMs, on macOS /Users/\<username\>/ROMs and on Windows C:\Users\\<username\>\ROMs\. If the --home command line option was used to start ES-DE, the tilde `~` symbol will resolve to whatever directory was passed as an argument to this option.
+The default game folder is ~/ROMs. On Unix this defaults to /home/\<username\>/ROMs, on macOS /Users/\<username\>/ROMs and on Windows C:\Users\\<username\>\ROMs\. If the --home command line option was used to start ES-DE, the tilde symbol will resolve to whatever directory was passed as an argument to this option.
 
 Assuming the default ROM directory is used, we need to create a subdirectory corresponding to the \<path\> tag in es_systems.xml, for this example it's `nes`.
 
@@ -702,6 +702,32 @@ For Windows, ES-DE will look for _yuzu.exe_ in the system Path as well as in the
 
 Apart from the potential difficulty in locating the emulator binary, there are some special configuration steps required for the emulator, refer to the Yuzu website for more information about this.
 
+#### Nintendo Wii U
+
+This section is specific to Windows as Cemu is currently only supported on this operating system.
+
+Cemu works a bit different compared to most other emulators, with games stored in an unpacked format. The content of each game is divided into the three directories _code, content_ and _meta_.
+
+The first step is to prepare the target directory in the `wiiu` ROMs directory, for this example we'll go for the game _Super Mario 3D World_. So simply create a directory with this name inside the wiiu folder. It should look something like the following:
+```
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\
+```
+
+The next step is done inside the emulator user interface. You should install the game, any updates as well as optional DLCs to the Cemu NAND. After the installation is completed, right click on the game and choose _Game directory_. An Explorer window should now open showing the content of the game. Here's the game directory for our example:
+```
+C:\Games\cemu\mlc01\usr\title\00050000\10145d00\code
+```
+
+Go up one level and copy the _code, content_ and _meta_ directories and paste them into the C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\ directory. It should now look something like the following:
+
+```
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\code
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\content
+C:\Users\myusername\ROMs\wiiu\Super Mario 3D World\meta
+```
+
+Starting ES-DE should now show the _Super Mario 3D World_ entry for the Wii U system. The actual game file with the extension .rpx is stored inside the _code_ directory, and does not normally match the name of the game. For this example it's named `RedCarpet.rpx`. When scraping the .rpx file you therefore need to refine the search and manually enter the game name. ES-DE fully supports scraping of directories, so you can scrape the _Super Mario 3D World_ folder as well.
+
 #### Sony PlayStation 3
 
 The RPCS3 emulator requires a bit of special setup.