Mednafen

This is based on the Mednafen v1.29 source code with various hacks to make it
work for AmigaOS4.

This is version 1.243.

Version 0.122, since version 0.107 (first release):
- Attempted to fix sound issue.

Version 0.135, since version 0.122:
- Compiled using GL4ES libraries
- Remove screenblanker from appearing whilst using mednafen
- Always call de-initialiser rourtines on early exit instead of returning
  without cleanup
- Icons are now added; thank you Samo79

Version 1.186, since 0.135:
- Built using latest CLIB2 (afxgroup). This seems to solve the DSI errors that
  occur due to threading
- Added versioning
- Changed the window title to include the version of mednafen, game and module
- Using CLIB2 seems to fix the GBA module; so now this is available but
  untested
- Sega Saturn also builds, but I have not tested it -- Basically, all the
  modules build
- Incorporated Samo79's great contributions which includes more documentation
- Extract the LHA and READ the section below titled "The configuration file"

Version 1.243 since 1.186:
- Fixed the minimize gadget not showing on initial window mode startup
- Added the SegaSaturn (SS) module by forcing building via 32-bit PPC code;
  this is very slow since a quad core CPU is required
- Fixed a slow down caused by linking with SDL2/GL4ES library that was dumping
  debug information to serial due to a non-release build
- Linked with bleeding edge (at the time of 14/12Dec/22) GL4ES, SDL2 libraries

Mednafen is a command line based multiple-console emulator. You run it from
the command line. Read on before invoking it; PARTICULARLY the next two
sections. You can use wrapper programs like EGame to avoid using the command
line.

===
The configuration directory:
===
- The first thing Mednafen wants to do is to create (or find) a configuration
  directory
- You either need to set an environment variable named HOME or MEDNAFEN_HOME
- MEDNAFEN_HOME is taken in preference, and it should contain the full path to
  the directory where the MEDNAFEN configuration (will) exists. If I run:
  "SETENV MEDNAFEN_HOME SYS:S/.mednafen", then Mednafen will look within there
  for the configuration files, saves, etc
- If MEDNAFEN_HOME is not set, then Mednafen will use the environment variable
  HOME instead. It behaves differently, though, since Mednafen then assumes
  that there is a ".mednefan" folder inside of HOME
- If either of these variables have a trailing '/' then things will not work
  properly
- TLDR: Create an environment variables named MEDNAFEN_HOME and give it the
  full path to the configuration folder
- If none of these variables exist, the game will not run anyway

===
The configuration file:
===
The default configuration file can be used, but do the following:
- Change "cd.image_memcache" to value "1" (Optional, but advised)
- Change "sound.period_time" to value "100000" (Definitely)
- Change "video.glvsync" to value "0" (Optional, but may help)
- Change "video.blit_timesync" to value "0" (Optional, but may help)

===
Useful key commands to know:
===
- ALT+ENTER => Toggle Fullscreen
- ALT+SHIFT+1 => Set up your controls for whatever module you are playing

===
Built with:
===
- ADTOOLS GCC 11.3, SDK 54.16, SDL 2.25.0, CLIB2 (afxgroup) + GL4ES

===
Hardware considerations:
===
This port of Mednafen has been tested on an AmigaOne X5020 and the Playstation
module is definitely playable - even though the recommendation is a dual core
CPU. I have also tried it on an X1000 with a 7950HD with relatively poor
results.