Short:        Mednafen
Author:       rjd324 (Ryan Dixon)
Uploader:     3246251196ryan gmail com
Type:         misc/emu
Version:      1.253
Architecture: ppc-amigaos
Distribution: Aminet
Kurz:         Mednafen

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

Supported game systems:
- Apple II/II+
- Atari Lynx
- Neo Geo Pocket (Color)
- WonderSwan
- GameBoy (Color)
- GameBoy Advance
- Nintendo Entertainment System
- Super Nintendo Entertainment System/Super Famicom
- Virtual Boy
- PC Engine/TurboGrafx 16 (CD)
- SuperGrafx
- PC-FX
- Sega Game Gear
- Sega Genesis/Megadrive
- Sega Master System
- Sega Saturn (64-bit only)
- Sony PlayStation

This is version 1.253.

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

Version 1.253 since 1.243:
- No changes other than the README document. The document and description
  fields now include which game systems are supported so that searches for
  those systems now actually match with mednafen

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.