Qt: Fix Qt 5 build harder

The base video size of the Game Boy core is the Super Game Boy’s resolution of 256×224 pixels.
Previously frames were exported at that size, leading to a 160×144 frame surrounded by uninitialized memory.

This assumes that the base size is always greater or equal to the current video size.

.appveyor.yml

@@ -0,0 +1,22 @@
+image:
+- Visual Studio 2019
+platform:
+- x64
+configuration:
+- Release
+install:
+- git -C C:\Tools\vcpkg clean -dfq docs ports scripts toolsrc triplets versions
+- git -C C:\Tools\vcpkg pull --force --quiet
+- C:\Tools\vcpkg\bootstrap-vcpkg
+- vcpkg --triplet x64-windows-release --recurse install ffmpeg libepoxy libpng libzip lua sdl2 sqlite3
+- vcpkg --no-dry-run upgrade
+- rd /Q /S C:\Tools\vcpkg\buildtrees
+before_build:
+- cmake . -DCMAKE_PREFIX_PATH=C:\Qt\5.15\msvc2019_64 \
+    -DCMAKE_TOOLCHAIN_FILE=C:\Tools\vcpkg\scripts\buildsystems\vcpkg.cmake \
+    -DVCPKG_TARGET_TRIPLET=x64-windows-release \
+    -DCMAKE_CONFIGURATION_TYPES=Release \
+    -DCMAKE_SYSTEM_VERSION=10.0.22000.1
+build:
+  parallel: true
+  project: mGBA.sln

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+patreon: mgba
+custom: https://mgba.io/donate.html

.travis-deps.sh

@@ -1,14 +0,0 @@
-#!/bin/sh
-if [ $TRAVIS_OS_NAME = "osx" ]; then
-	brew update
-	brew install qt5 ffmpeg imagemagick sdl2 libzip libpng
-else
-	sudo add-apt-repository ppa:spvkgn/ffmpeg+mpv -y
-	sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
-	sudo apt-get update -qq
-	sudo apt-get purge cmake -qq
-	sudo apt-get install -y -qq cmake libedit-dev libmagickwand-dev \
-		libpng-dev libsdl2-dev libzip-dev qtbase5-dev \
-		libqt5opengl5-dev qtmultimedia5-dev libavcodec-dev \
-		libavutil-dev libavformat-dev libavresample-dev libswscale-dev
-fi

.travis.yml

@@ -1,16 +0,0 @@
-os:
-  - linux
-  - osx
-
-language: c
-compiler:
-  - gcc
-  - clang
-
-sudo: required
-dist: trusty
-
-before_install:
-  - ./.travis-deps.sh
-
-script: mkdir build && cd build && cmake -DCMAKE_PREFIX_PATH=/usr/local/opt/qt5 .. && make

CMakePresets.json

@@ -0,0 +1,21 @@
+{
+    "version": 3,
+    "configurePresets": [
+        {
+            "name": "clang",
+            "generator": "Ninja",
+            "cacheVariables": {
+                "CMAKE_BUILD_TYPE": "Debug",
+                "CMAKE_EXPORT_COMPILE_COMMANDS": "ON"
+            }
+        },
+        {
+            "name": "gcc",
+            "generator": "Ninja",
+            "cacheVariables": {
+                "CMAKE_BUILD_TYPE": "Debug",
+                "CMAKE_EXPORT_COMPILE_COMMANDS": "ON"
+            }
+        }
+    ]
+}

CONTRIBUTING.md

@@ -55,18 +55,18 @@ Enum values and `#define`s should be all caps with underscores.
 Good:
 
 	static int _localVariable;
-	
+
 	struct LocalStruct {
 		void (*methodName)(struct LocalStruct struct, param);
-		
+
 		int memberName;
 	};
-	
+
 	enum {
 		ENUM_ITEM_1,
 		ENUM_ITEM_2
 	};
-	
+
 	void LocalStructCreate(struct LocalStruct* struct);
 	
 	void functionName(int argument);
@@ -124,7 +124,7 @@ Bad (missing space):
 	if (condition){
 		block;
 	}
-	
+
 ### Spacing
 
 Indentation should be done using tabs and should match the level of braces. Alignment within a line should be done sparingly, but only done with spaces.
@@ -137,9 +137,9 @@ Good:
 
 	#ifndef FILE_NAME_H
 	#define FILE_NAME_H
-	
+
 	// Header
-	
+
 	#endif
 
 There should be no comment on the `#endif`.

PORTING.md

@@ -10,15 +10,7 @@ The general porting process involves branching `master`, making the needed chang
 Port-specific TODO
 ------------------
 
-The ports are vaguely usable, but by no means should be considered stable.
-
-### 3DS (master)
-* Add audio
-* Thread support testing
-* Make it faster
-	* Threaded renderer shim
-	* ARMv6 dynarec
-	* Hardware acceleration
+The following ports are considered incomplete and are thus on branches still. They may work, but should not be considered stable.
 
 ### PSP (port/psp)
 * Add menu
@@ -27,12 +19,3 @@ The ports are vaguely usable, but by no means should be considered stable.
 * Make it faster
 	* MIPS dynarec
 	* Hardware acceleration
-
-### PS Vita (master)
-* Make it faster
-	* Threaded renderer shim
-	* Hardware acceleration
-
-### Wii (master)
-* Thread support
-* Clean up video detection

README.md

@@ -1,60 +1,106 @@
 mGBA
 ====
 
-mGBA is a new emulator for running Game Boy Advance games. It aims to be faster and more accurate than many existing Game Boy Advance emulators, as well as adding features that other emulators lack.
+mGBA is an emulator for running Game Boy Advance games. It aims to be faster and more accurate than many existing Game Boy Advance emulators, as well as adding features that other emulators lack. It also supports Game Boy and Game Boy Color games.
 
-Up-to-date news and downloads can be found at [mgba.io](http://mgba.io/).
+Up-to-date news and downloads can be found at [mgba.io](https://mgba.io/).
 
-[![Build status](https://travis-ci.org/mgba-emu/mgba.svg?branch=master)](https://travis-ci.org/mgba-emu/mgba)
+[![Build status](https://buildbot.mgba.io/badges/build-win32.svg)](https://buildbot.mgba.io)
+[![Translation status](https://hosted.weblate.org/widgets/mgba/-/svg-badge.svg)](https://hosted.weblate.org/engage/mgba)
 
 Features
 --------
 
-- Near full Game Boy Advance hardware support[<sup>[1]</sup>](#missing).
+- Highly accurate Game Boy Advance hardware support[<sup>[1]</sup>](#missing).
+- Game Boy/Game Boy Color hardware support.
 - Fast emulation. Known to run at full speed even on low end hardware, such as netbooks.
 - Qt and SDL ports for a heavy-weight and a light-weight frontend.
 - Local (same computer) link cable support.
 - Save type detection, even for flash memory size[<sup>[2]</sup>](#flashdetect).
 - Support for cartridges with motion sensors and rumble (only usable with game controllers).
 - Real-time clock support, even without configuration.
+- Solar sensor support for Boktai games.
+- Game Boy Camera and Game Boy Printer support.
 - A built-in BIOS implementation, and ability to load external BIOS files.
+- Scripting support using Lua.
 - Turbo/fast-forward support by holding Tab.
+- Rewind by holding Backquote.
 - Frameskip, configurable up to 10.
 - Screenshot support.
 - Cheat code support.
 - 9 savestate slots. Savestates are also viewable as screenshots.
-- Video and GIF recording.
+- Video, GIF, WebP, and APNG recording.
+- e-Reader support.
 - Remappable controls for both keyboards and gamepads.
 - Loading from ZIP and 7z files.
 - IPS, UPS and BPS patch support.
-- Game debugging via a command-line interface (not available with Qt port) and GDB remote support, compatible with IDA Pro.
+- Game debugging via a command-line interface and GDB remote support, compatible with Ghidra and IDA Pro.
 - Configurable emulation rewinding.
 - Support for loading and exporting GameShark and Action Replay snapshots.
+- Cores available for RetroArch/Libretro and OpenEmu.
+- Community-provided translations for several languages via [Weblate](https://hosted.weblate.org/engage/mgba).
+- Many, many smaller things.
+
+#### Game Boy mappers
+
+The following mappers are fully supported:
+
+- MBC1
+- MBC1M
+- MBC2
+- MBC3
+- MBC3+RTC
+- MBC30
+- MBC5
+- MBC5+Rumble
+- MBC7
+- Wisdom Tree (unlicensed)
+- NT "old type" 1 and 2 (unlicensed multicart)
+- NT "new type" (unlicensed MBC5-like)
+- Pokémon Jade/Diamond (unlicensed)
+- Sachen MMC1 (unlicensed)
+
+The following mappers are partially supported:
+
+- MBC6 (missing flash memory write support)
+- MMM01
+- Pocket Cam
+- TAMA5 (incomplete RTC support)
+- HuC-1 (missing IR support)
+- HuC-3 (missing IR support)
+- Sachen MMC2 (missing alternate wiring support)
+- BBD (missing logo switching)
+- Hitek (missing logo switching)
+- GGB-81 (missing logo switching)
+- Li Cheng (missing logo switching)
+- Sintax (missing logo switching)
 
 ### Planned features
 
-- Networked multiplayer link cable support ([Bug #1](http://mgba.io/b/1)).
-- Dolphin/JOY bus link cable support ([Bug #73](http://mgba.io/b/73)).
-- Re-recording support for tool-assist runs. ([Bugzilla keyword "TASBlocker"](https://endrift.com/mgba/bugs/buglist.cgi?quicksearch=TASBlocker))
-- Lua support for scripting ([Bug #62](http://mgba.io/b/62)).
-- A comprehensive debug suite ([Bug #132](http://mgba.io/b/132)).
-- OpenEmu core.
-- e-Reader support. ([Bug #171](http://mgba.io/b/171))
-
+- Networked multiplayer link cable support.
+- Dolphin/JOY bus link cable support.
+- MP2k audio mixing, for higher quality sound than hardware.
+- Re-recording support for tool-assist runs.
+- A comprehensive debug suite.
+- Wireless adapter support.
 
 Supported Platforms
 -------------------
 
-- Windows Vista or newer
-- OS X 10.7 (Lion)[<sup>[3]</sup>](#osxver) or newer
+- Windows 7 or newer
+- OS X 10.9 (Mavericks)[<sup>[3]</sup>](#osxver) or newer
 - Linux
 - FreeBSD
+- Nintendo 3DS
+- Nintendo Switch
+- Wii
+- PlayStation Vita
 
 Other Unix-like platforms, such as OpenBSD, are known to work as well, but are untested and not fully supported.
 
 ### System requirements
 
-Requirements are minimal. Any computer that can run Windows Vista or newer should be able to handle emulation. Support for OpenGL 1.1 or newer is also required.
+Requirements are minimal. Any computer that can run Windows Vista or newer should be able to handle emulation. Support for OpenGL 1.1 or newer is also required, with OpenGL 3.2 or newer for shaders and advanced features.
 
 Downloads
 ---------
@@ -64,7 +110,7 @@ Downloads can be found on the official website, in the [Downloads][downloads] se
 Controls
 --------
 
-Controls are configurable in the menu. The default gamepad controls are mapped so as to work with a DualShock 3. The default keyboard controls are as follows:
+Controls are configurable in the settings menu. Many game controllers should be automatically mapped by default. The default keyboard controls are as follows:
 
 - **A**: X
 - **B**: Z
@@ -76,7 +122,36 @@ Controls are configurable in the menu. The default gamepad controls are mapped s
 Compiling
 ---------
 
-Compiling requires using CMake 2.8.11 or newer. GCC and Clang are both known to work to compile mGBA, but Visual Studio 2013 and older are known not to work. Support for Visual Studio 2015 and newer is coming soon. To use CMake to build on a Unix-based system, the recommended commands are as follows:
+Compiling requires using CMake 3.1 or newer. GCC, Clang, and Visual Studio 2019 are known to work for compiling mGBA.
+
+#### Docker building
+
+The recommended way to build for most platforms is to use Docker. Several Docker images are provided that contain the requisite toolchain and dependencies for building mGBA across several platforms.
+
+Note: If you are on an older Windows system before Windows 10, you may need to configure your Docker to use VirtualBox shared folders to correctly map your current `mgba` checkout directory to the Docker image's working directory. (See issue [#1985](https://mgba.io/i/1985) for details.)
+
+To use a Docker image to build mGBA, simply run the following command while in the root of an mGBA checkout:
+
+	docker run --rm -it -v ${PWD}:/home/mgba/src mgba/windows:w32
+
+After starting the Docker container, it will produce a `build-win32` directory with the build products. Replace `mgba/windows:w32` with another Docker image for other platforms, which will produce a corresponding other directory. The following Docker images available on Docker Hub:
+
+- mgba/3ds
+- mgba/switch
+- mgba/ubuntu:xenial
+- mgba/ubuntu:bionic
+- mgba/ubuntu:focal
+- mgba/ubuntu:groovy
+- mgba/vita
+- mgba/wii
+- mgba/windows:w32
+- mgba/windows:w64
+
+If you want to speed up the build process, consider adding the flag `-e MAKEFLAGS=-jN` to do a parallel build for mGBA with `N` number of CPU cores.
+
+#### *nix building
+
+To use CMake to build on a Unix-based system, the recommended commands are as follows:
 
 	mkdir build
 	cd build
@@ -86,11 +161,23 @@ Compiling requires using CMake 2.8.11 or newer. GCC and Clang are both known to
 
 This will build and install mGBA into `/usr/bin` and `/usr/lib`. Dependencies that are installed will be automatically detected, and features that are disabled if the dependencies are not found will be shown after running the `cmake` command after warnings about being unable to find them.
 
+If you are on macOS, the steps are a little different. Assuming you are using the homebrew package manager, the recommended commands to obtain the dependencies and build are:
+
+	brew install cmake ffmpeg libzip qt5 sdl2 libedit lua pkg-config
+	mkdir build
+	cd build
+	cmake -DCMAKE_PREFIX_PATH=`brew --prefix qt5` ..
+	make
+
+Note that you should not do a `make install` on macOS, as it will not work properly.
+
 #### Windows developer building
 
-To build on Windows for development, using MSYS2 is recommended. Follow the installation steps found on their [website](https://msys2.github.io). Make sure you're running the 32-bit version ("MinGW-w64 Win32 Shell") and run this additional command (including the braces) to install the needed dependencies (please note that this involves downloading over 500MiB of packages, so it will take a long time):
+##### MSYS2
 
-	pacman -Sy mingw-w64-i686-{cmake,ffmpeg,gcc,gdb,imagemagick,libzip,pkg-config,qt5,SDL2}
+To build on Windows for development, using MSYS2 is recommended. Follow the installation steps found on their [website](https://msys2.github.io). Make sure you're running the 32-bit version ("MSYS2 MinGW 32-bit") (or the 64-bit version "MSYS2 MinGW 64-bit" if you want to build for x86_64) and run this additional command (including the braces) to install the needed dependencies (please note that this involves downloading over 1100MiB of packages, so it will take a long time):
+
+	pacman -Sy --needed base-devel git ${MINGW_PACKAGE_PREFIX}-{cmake,ffmpeg,gcc,gdb,libelf,libepoxy,libzip,lua,pkgconf,qt5,SDL2,ntldd-git}
 
 Check out the source code by running this command:
 
@@ -98,13 +185,42 @@ Check out the source code by running this command:
 
 Then finally build it by running these commands:
 
-	cd mgba
+	mkdir -p mgba/build
+	cd mgba/build
+	cmake .. -G "MSYS Makefiles"
+	make -j$(nproc --ignore=1)
+
+Please note that this build of mGBA for Windows is not suitable for distribution, due to the scattering of DLLs it needs to run, but is perfect for development. However, if distributing such a build is desired (e.g. for testing on machines that don't have the MSYS2 environment installed), running `cpack -G ZIP` will prepare a zip file with all of the necessary DLLs.
+
+##### Visual Studio
+
+To build using Visual Studio is a similarly complicated setup. To begin you will need to install [vcpkg](https://github.com/Microsoft/vcpkg). After installing vcpkg you will need to install several additional packages:
+
+    vcpkg install ffmpeg[vpx,x264] libepoxy libpng libzip lua sdl2 sqlite3
+
+Note that this installation won't support hardware accelerated video encoding on Nvidia hardware. If you care about this, you'll need to install CUDA beforehand, and then substitute `ffmpeg[vpx,x264,nvcodec]` into the previous command.
+
+You will also need to install Qt. Unfortunately due to Qt being owned and run by an ailing company as opposed to a reasonable organization there is no longer an offline open source edition installer for the latest version, so you'll need to either fall back to an [old version installer](https://download.qt.io/official_releases/qt/5.12/5.12.9/qt-opensource-windows-x86-5.12.9.exe) (which wants you to create an otherwise-useless account, but you can bypass temporarily setting an invalid proxy or otherwise disabling networking), use the online installer (which requires an account regardless), or use vcpkg to build it (slowly). None of these are great options. For the installer you'll want to install the applicable MSVC versions. Note that the offline installers do not support MSVC 2019. For vcpkg you'll want to install it as such, which will take quite a while, especially on quad core or less computers:
+
+    vcpkg install qt5-base qt5-multimedia
+
+Next, open Visual Studio, select Clone Repository, and enter `https://github.com/mgba-emu/mgba.git`. When Visual Studio is done cloning, go to File > CMake and open the CMakeLists.txt file at the root of the checked out repository. From there, mGBA can be developed in Visual Studio similarly to other Visual Studio CMake projects.
+
+#### Toolchain building
+
+If you have devkitARM (for 3DS), devkitPPC (for Wii), devkitA64 (for Switch), or vitasdk (for PS Vita), you can use the following commands for building:
+
 	mkdir build
 	cd build
-	cmake .. -G "MSYS Makefiles"
+	cmake -DCMAKE_TOOLCHAIN_FILE=../src/platform/3ds/CMakeToolchain.txt ..
 	make
 
-Please note that this build of mGBA for Windows is not suitable for distribution, due to the scattering of DLLs it needs to run, but is perfect for development.
+Replace the `-DCMAKE_TOOLCHAIN_FILE` parameter for the following platforms:
+
+- 3DS: `../src/platform/3ds/CMakeToolchain.txt`
+- Switch: `../src/platform/switch/CMakeToolchain.txt`
+- Vita: `../src/platform/psp2/CMakeToolchain.vitasdk`
+- Wii: `../src/platform/wii/CMakeToolchain.txt`
 
 ### Dependencies
 
@@ -114,9 +230,14 @@ mGBA has no hard dependencies, however, the following optional dependencies are
 - SDL: for a more basic frontend and gamepad support in the Qt frontend. SDL 2 is recommended, but 1.2 is supported.
 - zlib and libpng: for screenshot support and savestate-in-PNG support.
 - libedit: for command-line debugger support.
-- ffmpeg or libav: for video recording.
-- libzip: for loading ROMs stored in zip files.
-- ImageMagick: for GIF recording.
+- ffmpeg or libav: for video, GIF, WebP, and APNG recording.
+- libzip or zlib: for loading ROMs stored in zip files.
+- SQLite3: for game databases.
+- libelf: for ELF loading.
+- Lua: for scripting.
+- json-c: for the scripting `storage` API.
+
+SQLite3, libpng, and zlib are included with the emulator, so they do not need to be externally compiled first.
 
 Footnotes
 ---------
@@ -124,11 +245,10 @@ Footnotes
 <a name="missing">[1]</a> Currently missing features are
 
 - OBJ window for modes 3, 4 and 5 ([Bug #5](http://mgba.io/b/5))
-- Mosaic for transformed OBJs ([Bug #9](http://mgba.io/b/9))
 
 <a name="flashdetect">[2]</a> Flash memory size detection does not work in some cases. These can be configured at runtime, but filing a bug is recommended if such a case is encountered.
 
-<a name="osxver">[3]</a> 10.7 is only needed for the Qt port. The SDL port is known to work on 10.6, and may work on older.
+<a name="osxver">[3]</a> 10.9 is only needed for the Qt port. It may be possible to build or running the Qt port on 10.7 or older, but this is not officially supported. The SDL port is known to work on 10.5, and may work on older.
 
 [downloads]: http://mgba.io/downloads.html
 [source]: https://github.com/mgba-emu/mgba/
@@ -136,11 +256,14 @@ Footnotes
 Copyright
 ---------
 
-mGBA is Copyright © 2013 – 2015 Jeffrey Pfau. It is distributed under the [Mozilla Public License version 2.0](https://www.mozilla.org/MPL/2.0/). A copy of the license is available in the distributed LICENSE file.
+mGBA is Copyright © 2013 – 2023 Jeffrey Pfau. It is distributed under the [Mozilla Public License version 2.0](https://www.mozilla.org/MPL/2.0/). A copy of the license is available in the distributed LICENSE file.
 
 mGBA contains the following third-party libraries:
 
-- [inih](https://code.google.com/p/inih/), which is copyright © 2009 Ben Hoyt and used under a BSD 3-clause license.
-- [blip-buf](https://code.google.com/p/blip-buf/), which is copyright © 2003 – 2009 Shay Green and used under a Lesser GNU Public License.
+- [inih](https://github.com/benhoyt/inih), which is copyright © 2009 – 2020 Ben Hoyt and used under a BSD 3-clause license.
 - [LZMA SDK](http://www.7-zip.org/sdk.html), which is public domain.
-- [MurmurHash3](https://code.google.com/p/smhasher/wiki/MurmurHash3) implementation by Austin Appleby, which is public domain.
+- [MurmurHash3](https://github.com/aappleby/smhasher) implementation by Austin Appleby, which is public domain.
+- [getopt for MSVC](https://github.com/skandhurkat/Getopt-for-Visual-Studio/), which is public domain.
+- [SQLite3](https://www.sqlite.org), which is public domain.
+
+If you are a game publisher and wish to license mGBA for commercial usage, please email [licensing@mgba.io](mailto:licensing@mgba.io) for more information.

README_DE.md

@@ -0,0 +1,255 @@
+mGBA
+====
+
+mGBA ist ein Emulator für Game Boy Advance-Spiele. Das Ziel von mGBA ist, schneller und genauer als viele existierende Game Boy Advance-Emulatoren zu sein. Außerdem verfügt mGBA über Funktionen, die anderen Emulatoren fehlen. Zusätzlich werden auch Game Boy- und Game Boy Color-Spiele unterstützt.
+
+Aktuelle Neuigkeiten und Downloads findest Du auf [mgba.io](https://mgba.io).
+
+[![Build-Status](https://travis-ci.org/mgba-emu/mgba.svg?branch=master)](https://travis-ci.org/mgba-emu/mgba)
+[![Status der Übersetzungen](https://hosted.weblate.org/widgets/mgba/-/svg-badge.svg)](https://hosted.weblate.org/engage/mgba)
+
+Features
+--------
+
+- Sehr genaue Unterstützung der Game Boy Advance-Hardware[<sup>[1]</sup>](#missing).
+- Unterstützung der Game Boy-/Game Boy Color-Hardware.
+- Schnelle Emulation. mGBA ist dafür bekannt, auch auf schwacher Hardware wie Netbooks mit voller Geschwindigkeit zu laufen.
+- Qt- und SDL-Portierungen für eine vollwertige und eine "leichtgewichtige" Benutzeroberfläche.
+- Lokale (gleicher Computer) Unterstützung für Link-Kabel.
+- Erkennung des Speichertypes, einschließlich der Größe des Flash-Speichers[<sup>[2]</sup>](#flashdetect).
+- Unterstützung für Spielmodule mit Bewegungssensoren und Rüttel-Effekten (nur verwendbar mit Spiele-Controllern).
+- Unterstützung für Echtzeituhren, selbst ohne Konfiguration.
+- Unterstützung für den Lichtsensor in Boktai-Spielen
+- Unterstützung für Game Boy Printer und Game Boy Camera.
+- Eingebaute BIOS-Implementierung mit der Möglichkeit, externe BIOS-Dateien zu laden.
+- Turbo/Vorlauf-Unterstützung durch drücken der Tab-Taste.
+- Rücklauf-Unterstützung durch drücken der Akzent-Taste.
+- Frameskip von bis zu 10 Bildern.
+- Unterstützung für Screenshots.
+- Unterstützung für Cheat-Codes.
+- 9 Speicherstände für Savestates/Spielzustände. Savestates können auch als Screenshots dargestellt werden.
+- Video-, GIF-, WebP- und APNG-Aufzeichnung.
+- e-Reader-Unterstützung.
+- Frei wählbare Tastenbelegungen für Tastaturen und Controller.
+- Unterstützung für ZIP- und 7z-Archive.
+- Unterstützung für Patches im IPS-, UPS- und BPS-Format.
+- Spiele-Debugging über ein Kommandozeilen-Interface und IDA Pro-kompatible GDB-Unterstützung.
+- Einstellbare Rücklauf-Funktion.
+- Unterstützung für das Laden und Exportieren von GameShark- und Action Replay-Abbildern.
+- Verfügbare Cores für RetroArch/Libretro und OpenEmu.
+- Übersetzungen für mehrere Sprachen über [Weblate](https://hosted.weblate.org/engage/mgba).
+- Viele, viele kleinere Dinge.
+
+### Game Boy-Mapper
+
+Die folgenden Mapper werden vollständig unterstützt:
+
+- MBC1
+- MBC1M
+- MBC2
+- MBC3
+- MBC3+RTC (MBC3+Echtzeituhr)
+- MBC5
+- MBC5+Rumble (MBC5+Rüttel-Modul)
+- MBC7
+- Wisdom Tree (nicht lizenziert)
+- Pokémon Jade/Diamond (nicht lizenziert)
+- BBD (nicht lizenziert, ählich MBC5)
+- Hitek (nicht lizenziert, ähnlich MBC5)
+
+Die folgenden Mapper werden teilweise unterstützt:
+
+- MBC6 (fehlende Unterstützung für Schreibzugriffe auf den Flash-Speicher)
+- MMM01
+- Pocket Cam
+- TAMA5 (fehlende RTC-Unterstützung)
+- HuC-1 (fehlende Infrarot-Unterstützung)
+- HuC-3 (fehlende RTC- und Infrarot-Unterstützung)
+
+### Geplante Features
+
+- Unterstützung für Link-Kabel-Multiplayer über ein Netzwerk.
+- Unterstützung für Link-Kabel über Dolphin/JOY-Bus.
+- MP2k-Audio-Abmischung für höhere Audio-Qualität als echte Hardware.
+- Unterstützung für Tool-Assisted Speedruns.
+- Lua-Unterstützung für Scripting.
+- Eine umfangreiche Debugging-Suite.
+- Unterstützung für Drahtlosadapter.
+
+Unterstützte Plattformen
+------------------------
+
+- Windows 7 oder neuer
+- OS X 10.9 (Mavericks)[<sup>[3]</sup>](#osxver) oder neuer
+- Linux
+- FreeBSD
+- Nintendo 3DS
+- Nintendo Switch
+- Wii
+- PlayStation Vita
+
+Andere Unix-ähnliche Plattformen wie OpenBSD sind ebenfalls dafür bekannt, mit mGBA kompatibel zu sein. Sie sind jedoch nicht getestet und werden nicht voll unterstützt.
+
+### Systemvoraussetzungen
+
+Die Systemvoraussetzungen sind minimal. Jeder Computer, der mit Windows Vista oder neuer läuft, sollte in der Lage sein, die Emulation zu bewältigen. Unterstützung für OpenGL 1.1 oder neuer ist ebenfalls voraussgesetzt. OpenGL 3.2 oder neuer wird für Shader und erweiterte Funktionen benötigt.
+
+Downloads
+---------
+
+Download-Links befinden sich in der [Downloads][downloads]-Sektion auf der offiziellen Website. Der Quellcode befindet sich auf [GitHub][source].
+
+Steuerung
+---------
+
+Die Steuerung kann im Einstellungs-Menü konfiguriert werden. Viele Spiele-Controller werden automatisch erkannt und entsprechend belegt. Für Tastaturen wird standardmäßig folgende Belegung verwendet:
+
+- **A**: X
+- **B**: Z
+- **L**: A
+- **R**: S
+- **Start**: Enter
+- **Select**: Rücktaste
+
+Kompilieren
+-----------
+
+Um mGBA kompilieren zu können, wird CMake 3.1 oder neuer benötigt. GCC und Clang sind beide dafür bekannt, mGBA kompilieren zu können. Visual Studio 2013 und älter funktionieren nicht. Unterstützung für Visual Studio 2015 und neuer wird bald hinzugefügt.
+
+#### Kompilieren mit Docker
+
+Der empfohlene Weg, um mGBA für die meisten Plattformen zu kompilieren, ist die Verwendung von Docker. Mehrere Docker-Images sind verfügbar, welche die benötigte Compiler-Umgebung und alle benötigten Abhängigkeiten beinhaltet, um mGBA für verschiedene Plattformen zu bauen.
+
+Um ein Docker-Image zum Bau von mGBA zu verwenden, führe einfach folgenden Befehl in dem Verzeichnis aus, in welches Du den mGBA-Quellcode ausgecheckt hast:
+
+	docker run --rm -t -v $PWD:/home/mgba/src mgba/windows:w32
+
+Dieser Befehl erzeugt ein Verzeichnis `build-win32` mit den erzeugten Programmdateien. Ersetze `mgba/windows:32` durch ein Docker-Image für eine andere Plattform, wodurch dann das entsprechende Verzeichnis erzeugt wird. Die folgenden Docker-Images sind im Docker Hub verfügbar:
+
+- mgba/3ds
+- mgba/switch
+- mgba/ubuntu:xenial
+- mgba/ubuntu:bionic
+- mgba/ubuntu:focal
+- mgba/ubuntu:groovy
+- mgba/vita
+- mgba/wii
+- mgba/windows:w32
+- mgba/windows:w64
+
+#### Unter *nix kompilieren
+
+Verwende folgende Befehle, um mGBA mithilfe von CMake auf einem Unix-basierten System zu bauen:
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr ..
+	make
+	sudo make install
+
+Damit wird mGBA gebaut und in `/usr/bin` und `/usr/lib` installiert. Installierte Abhängigkeiten werden automatisch erkannt. Features, die aufgrund fehlender Abhängigkeiten deaktiviert wurden, werden nach dem `cmake`-Kommando angezeigt.
+
+Wenn Du macOS verwendest, sind die einzelnen Schritte etwas anders. Angenommen, dass Du den Homebrew-Paketmanager verwendest, werden folgende Schritte zum installieren der Abhängigkeiten und anschließenden bauen von mGBA empfohlen:
+
+	brew install cmake ffmpeg libzip qt5 sdl2 libedit pkg-config
+	mkdir build
+	cd build
+	cmake -DCMAKE_PREFIX_PATH=`brew --prefix qt5` ..
+	make
+
+Bitte beachte, dass Du unter macOS nicht `make install` verwenden solltest, da dies nicht korrekt funktionieren wird.
+
+#### Für Entwickler: Kompilieren unter Windows
+
+##### MSYS2
+
+Um mGBA auf Windows zu kompilieren, wird MSYS2 empfohlen. Befolge die Installationsschritte auf der [MSYS2-Website](https://msys2.github.io). Stelle sicher, dass Du die 32-Bit-Version ("MSYS2 MinGW 32-bit") (oder die 64-Bit-Version "MSYS2 MinGW 64-bit", wenn Du mGBA für x86_64 kompilieren willst) verwendest und führe folgendes Kommando (einschließlich der Klammern) aus, um alle benötigten Abhängigkeiten zu installieren. Bitte beachte, dass dafür über 1100MiB an Paketen heruntergeladen werden, was eine Weile dauern kann:
+
+	pacman -Sy --needed base-devel git ${MINGW_PACKAGE_PREFIX}-{cmake,ffmpeg,gcc,gdb,libelf,libepoxy,libzip,pkgconf,qt5,SDL2,ntldd-git}
+
+Lade den aktuellen mGBA-Quellcode mithilfe des folgenden Kommandos herunter:
+
+	git clone https://github.com/mgba-emu/mgba.git
+
+Abschließend wird mGBA über folgende Kommandos kompiliert:
+
+	mkdir -p mgba/build
+	cd mgba/build
+	cmake .. -G "MSYS Makefiles"
+	make -j$(nproc --ignore=1)
+
+Bitte beachte, dass mGBA für Windows aufgrund der Vielzahl an benötigten DLLs nicht für die weitere Verteilung geeignet ist, wenn es auf diese Weise gebaut wurde. Es ist jedoch perfekt für Entwickler geeignet. Soll mGBA dennoch weiter verteilt werden (beispielsweise zu Testzwecken auf Systemen, auf denen keine MSYS2-Umgebung installiert ist), kann mithilfe des Befehls `cpack -G ZIP` ein ZIP-Archiv mit allen benötigten DLLs erstellt werden.
+
+##### Visual Studio
+
+mGBA mit Visual Studio zu bauen erfordert ein ähnlich kompliziertes Setup. Zuerst musst Du [vcpkg](https://github.com/Microsoft/vcpkg) installieren. Nachdem vcpkg installiert ist, musst Du noch folgende zusätzlichen Pakete installieren:
+
+	vcpkg install ffmpeg[vpx,x264] libepoxy libpng libzip sdl2 sqlite3
+
+Bitte beachte, dass diese Installation keine hardwarebeschleunigtes Video-Encoding auf Nvidia-Hardware unterstützen wird. Wenn Du darauf Wert legst, musst Du zuerst CUDA installieren und anschließend den vorherigen Befehl um `ffmpeg[vpx,x264,nvcodec]` ergänzen.
+
+Zusätzlich wirst Du auch Qt installieren müssen. Unglücklicherweise steht für Qt kein Offline-Installationsprogramm für die jeweils aktuelle Version bereit. Daher musst Du entweder auf eine [ältere Version](https://download.qt.io/official_releases/qt/5.12/5.12.9/qt-opensource-windows-x86-5.12.9.exe) zurückgreifen (hierfür benötigst Du ein ansonsten nutzloses Benutzerkonto, aber Du kannst das umgehen, indem Du temporär einen ungültigen Netzwerk-Proxy hinterlegst oder über andere Methoden deine Netzwerkverbindung deaktivierst). Alternativ kannst Du auch den Online-Installer nutzen (für den ohnehin ein Benutzeraccount erfortderlich ist) oder Qt selbst mithilfe von vcpkg bauen (was verhältnismäßig lange dauert). Keine dieser Optionen ist besonders elegant. Bitte achte bei der Verwendung eines Installers darauf, die passende MSVC-Version zu wählen. Der Offline-Installer unterstützt aktuell noch nicht MSVC 2019. Die Installation mit vcpkg dauert ein wenig länger, besonders, wenn Du einen Computer mit vier oder weniger CPU-Cores nutzt:
+
+    vcpkg install qt5-base qt5-multimedia
+
+Öffne anschließend Visual Studio, wähle "Clone Repository" und gib dort `https://github.com/mgba-emu/mgba.git` ein. Wenn Visual Studio das Repository geklont hat, gehe zu "Datei > CMake" und öffne die Datei CMakeLists.txt im Stammverzeichnis des ausgecheckten Repos. Anschließend kann mGBA in Visual Studio entwickelt werden, ähnlich wie andere Visual Studio CMake-Projekte.
+
+#### Kompilieren mithilfe einer Toolchain
+
+Wenn Du devkitARM (für 3DS), devkitPPC (für Wii), devkitA64 (für Switch) oder vitasdk (für PS Vita) installiert hast, kannst Du die folgenden Befehle zum Kompilieren verwenden:
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_TOOLCHAIN_FILE=../src/platform/3ds/CMakeToolchain.txt ..
+	make
+	
+Ersetze den Parameter `-DCMAKE_TOOLCHAIN_FILE` dabei folgendermaßen:
+
+- 3DS: `../src/platform/3ds/CMakeToolchain.txt`
+- Switch: `../src/platform/switch/CMakeToolchain.txt`
+- Vita: `../src/platform/psp2/CMakeToolchain.vitasdk`
+- Wii: `../src/platform/wii/CMakeToolchain.txt`
+
+### Abhängigkeiten
+
+mGBA hat keine "harten" Abhängigkeiten. Dennoch werden die folgenden optionalen Abhängigkeiten für einige Features benötigt. Diese Features werden automatisch deaktiviert, wenn die benötigten Abhängigkeiten nicht gefunden werden.
+
+- Qt 5: Für die Benutzeroberfläche. Qt Multimedia oder SDL werden für Audio-Ausgabe benötigt.
+- SDL: Für eine einfachere Benutzeroberfläche und Spiele-Controller-Unterstützung in der Qt-Oberfläche. SDL 2 ist empfohlen, SDL 1.2 wird jedoch auch unterstützt.
+- zlib und libpng: Für die Unterstützung von Bildschirmfotos und Savestates-in-PNG-Unterstützung.
+- libedit: Für die Unterstützung des Kommandozeilen-Debuggers.
+- ffmpeg oder libav: Für Videoaufzeichnungen.
+- libzip oder zlib: Um ROMs aus ZIP-Dateien zu laden.
+- SQLite3: Für Spiele-Datenbanken.
+- libelf: Für das Laden von ELF-Dateien.
+
+SQLite3, libpng und zlib werden mit dem Emulator mitgeliefert, sodass sie nicht zuerst kompiliert werden müssen.
+
+Fußnoten
+--------
+
+<a name="missing">[1]</a> Zurzeit fehlende Features sind
+
+- OBJ-Fenster für die Modi 3, 4 und 5 ([Bug #5](http://mgba.io/b/5))
+
+<a name="flashdetect">[2]</a> In manchen Fällen ist es nicht möglich, die Größe des Flash-Speichers automatisch zu ermitteln. Diese kann dann zur Laufzeit konfiguriert werden, es wird jedoch empfohlen, den Fehler zu melden.
+
+<a name="osxver">[3]</a> 10.9 wird nur für die Qt-Portierung benötigt. Es ist wahrscheinlich möglich, die Qt-Portierung unter macOS 10.7 und älter zu bauen und zu nutzen, aber das wird nicht offiziell unterstützt. Die SDL-Portierung ist dafür bekannt, mit 10.7 und möglicherweise auf älteren Versionen zu funktionieren.
+
+[downloads]: http://mgba.io/downloads.html
+[source]: https://github.com/mgba-emu/mgba/
+
+Copyright
+---------
+
+Copyright für mGBA © 2013 – 2021 Jeffrey Pfau. mGBA wird unter der [Mozilla Public License version 2.0](https://www.mozilla.org/MPL/2.0/) veröffentlicht. Eine Kopie der Lizenz ist in der mitgelieferten Datei LICENSE verfügbar.
+
+mGBA beinhaltet die folgenden Bibliotheken von Drittanbietern:
+
+- [inih](https://github.com/benhoyt/inih), Copyright © 2009 - 2020 Ben Hoyt, verwendet unter einer BSD 3-clause-Lizenz.
+- [LZMA SDK](http://www.7-zip.org/sdk.html), Public Domain.
+- [MurmurHash3](https://github.com/aappleby/smhasher), Implementierung von Austin Appleby, Public Domain.
+- [getopt fot MSVC](https://github.com/skandhurkat/Getopt-for-Visual-Studio/), Public Domain.
+- [SQLite3](https://www.sqlite.org), Public Domain.
+
+Wenn Du ein Spiele-Publisher bist und mGBA für kommerzielle Verwendung lizenzieren möchtest, schreibe bitte eine e-Mail an [licensing@mgba.io](mailto:licensing@mgba.io) für weitere Informationen.

README_ES.md

@@ -0,0 +1,255 @@
+mGBA
+====
+
+mGBA es un emulador para juegos de Game Boy Advance. Su objetivo es ser más rápido y más preciso que muchos emuladores de Game Boy Advance existentes, además de añadir funciones que otros emuladores no tienen. También es compatible con juegos de Game Boy y Game Boy Color.
+
+Las noticias actualizadas y las descargas se encuentran en [mgba.io](https://mgba.io/).
+
+[![Estado de la compilación](https://travis-ci.org/mgba-emu/mgba.svg?branch=master)](https://travis-ci.org/mgba-emu/mgba)
+[![Estado de la traducción](https://hosted.weblate.org/widgets/mgba/-/svg-badge.svg)](https://hosted.weblate.org/engage/mgba)
+
+Características
+--------
+
+- Soporte de hardware Game Boy Advance altamente preciso[<sup>[1]</sup>](#missing).
+- Soporte de hardware Game Boy/Game Boy Color.
+- Emulación rápida. Corre a velocidad completa en hardware de gama baja, como los netbooks.
+- Interfaz gráfica en SDL y Qt.
+- Soporte para cable de enlace (link cable) local (en la misma computadora).
+- Detección de tipos de guardado, incluso para tamaños de memoria flash[<sup>[2]</sup>](#flashdetect).
+- Soporte para cartuchos con sensores de movimiento y vibración (solo usable con mandos).
+- Soporte para reloj en tiempo real, incluso sin configuración.
+- Soporte para sensor solar, para juegos Boktai.
+- Soporta la Cámara y la Impresora Game Boy.
+- Implementación interna de BIOS, y opción para usar una BIOS externa.
+- Modo turbo/avance rápido al mantener Tab presionado.
+- Retroceder al presionar "`".
+- Salto de cuadros de hasta 10 cuadros por vez.
+- Captura de pantalla (pantallazo).
+- Soporta códigos de truco.
+- 9 espacios para estados de guardado. Estos tambien pueden ser vistos como pantallazos.
+- Grabación de video, GIF, WebP, y APNG.
+- Soporte para e-Reader.
+- Controles modificables para teclado y mandos.
+- Cargar desde archivos ZIP y 7z.
+- Soporta parches IPS, UPS y BPS.
+- Depuración de juegos a través de una interfaz de línea de comandos y soporte remoto GDB, compatible con IDA Pro.
+- Retroceso configurable.
+- Soporte para cargar y exportar instantáneas de GameShark y Action Replay.
+- Núcleos disponibles para RetroArch/Libretro y OpenEmu.
+- Traducciones de la comunidad a través de [Weblate](https://hosted.weblate.org/engage/mgba).
+- Otras cosas más pequeñas.
+
+#### Mappers (controladores de memoria) soportados
+
+Estos mappers tienen soporte completo:
+
+- MBC1
+- MBC1M
+- MBC2
+- MBC3
+- MBC3+RTC
+- MBC5
+- MBC5+Rumble
+- MBC7
+- Wisdom Tree (sin licencia)
+- Pokémon Jade/Diamond (sin licencia)
+- BBD (sin licencia, similar a MBC5)
+- Hitek (sin licencia, similar a MBC5)
+
+Estos mappers tienen soporte parcial:
+
+- MBC6 (sin soporte para escribir a la memoria flash)
+- MMM01
+- Pocket Cam
+- TAMA5 (sin soporte para RTC)
+- HuC-1 (sin soporte para IR)
+- HuC-3 (sin soporte para RTC e IR)
+
+### Características planeadas
+
+- Soporte para cable de enlace por red.
+- Soporte para cable de enlace por Joybus para Dolphin.
+- Mezcla de audio MP2k, para mayor calidad de sonido.
+- Soporte de regrabación para speedruns asistidos por herramientas (TAS).
+- Soporte de Lua para prog.
+- Un completo paquete de depuración.
+- Compatibilidad con adaptadores inalámbricos.
+
+Plataformas soportadas
+-------------------
+
+- Windows 7 o más reciente
+- OS X 10.9 (Mavericks)[<sup>[3]</sup>](#osxver) o más reciente
+- Linux
+- FreeBSD
+- Nintendo 3DS
+- Nintendo Switch
+- Wii
+- PlayStation Vita
+
+Otras plataformas Unix-like, como OpenBSD, funcionan también, pero no han sido probadas.
+
+### Requisitos de sistema
+
+Los requisitos son mínimos. Cualquier computadora que pueda ejecutar Windows Vista o más reciente debería ser capaz de emular. También se requiere soporte para OpenGL 1.1 o más reciente, con OpenGL 3.2 o más reciente para los shaders y las funciones avanzadas.
+
+Descargas
+---------
+
+Las descargas se pueden encontrar en la página web oficial, en la sección [Descargas][downloads]. El código fuente se puede encontrar en [GitHub][source].
+
+Controles
+--------
+
+Los controles son configurables en el menú de configuración. Many game controllers should be automatically mapped by default. The default keyboard controls are as follows:
+
+- **A**: X
+- **B**: Z
+- **L**: A
+- **R**: S
+- **Start**: Entrar
+- **Select**: Retroceso
+
+Compilar
+---------
+
+La compilación requiere el uso de CMake 3.1 o más reciente. GCC y Clang funcionan para compilar mGBA, pero Visual Studio 2013 y posteriores no funcionan. El soporte para Visual Studio 2015 y más recientes llegará pronto.
+
+#### Compilación por Docker
+
+Recomendamos usar Docker para compilar en la mayoría de las plataformas. Proporcionamos varias imágenes Docker que contienen la cadena de herramientas y las dependencias necesarias para compilar mGBA a través de varias plataformas. 
+
+Para usar una imagen Docker para compilar mGBA, ejecuta este comando mientras estés en el directorio donde hayas desplegado (checkout) el código fuente de mGBA:
+
+	docker run --rm -t -v $PWD:/home/mgba/src mgba/windows:w32
+
+Esto producirá un directorio `build-win32` con los ejecutables compilados. Reemplaza `mgba/windows:w32` con otro nombre de imagen Docker para otras plataformas, lo cual creará un directorio correspondiente. Las siguientes imágenes están disponibles en Docker Hub:
+
+- mgba/3ds
+- mgba/switch
+- mgba/ubuntu:xenial
+- mgba/ubuntu:bionic
+- mgba/ubuntu:focal
+- mgba/ubuntu:groovy
+- mgba/vita
+- mgba/wii
+- mgba/windows:w32
+- mgba/windows:w64
+
+#### Compilación en *nix
+
+Si quieres usar CMake para compilar mGBA en un sistema Unix-like, recomendamos los siguientes comandos:
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr ..
+	make
+	sudo make install
+
+Esto compilará e instalará mGBA en `/usr/bin` y `/usr/lib`. Las dependencias que estén instaladas serán detectadas automáticamente, y las características que estén desactivadas si las dependencias no se encuentran serán mostradas después de que el comando `cmake` muestre las advertencias.
+
+Si estás en macOS, los pasos son un poco diferentes. Asumiendo que usas el gestor de paquetes Homebrew, los comandos recomendados para obtener las dependencias y compilar mGBA son:
+
+	brew install cmake ffmpeg libzip qt5 sdl2 libedit pkg-config
+	mkdir build
+	cd build
+	cmake -DCMAKE_PREFIX_PATH=`brew --prefix qt5` ..
+	make
+
+Toma nota de que no debes usar `make install` en macOS, ya que no funcionará correctamente.
+
+#### Compilación en Windows para desarrolladores
+
+##### MSYS2
+
+Para desarrollar en Windows, recomendamos MSYS2. Sigue las instrucciones en su [sitio web](https://msys2.github.io). Asegúrate de que estés ejecutando la versión de 32 bits ("MSYS2 MinGW 32-bit") (o la versión de 64 bits "MSYS2 MinGW 64-bit" si quieres compilar para x86_64) y ejecuta estos comandos adicionales para instalar las dependencias necesarias (toma nota de que esto descargará más de 1100 MB en paquetes, así que puede demorarse un poco):
+
+	pacman -Sy --needed base-devel git ${MINGW_PACKAGE_PREFIX}-{cmake,ffmpeg,gcc,gdb,libelf,libepoxy,libzip,pkgconf,qt5,SDL2,ntldd-git}
+
+Despliega (haz check out en) el código fuente ejecutando este comando:
+
+	git clone https://github.com/mgba-emu/mgba.git
+
+Luego, compílalo usando estos comandos:
+
+	mkdir -p mgba/build
+	cd mgba/build
+	cmake .. -G "MSYS Makefiles"
+	make -j$(nproc --ignore=1)
+
+Ten en cuenta de que esta versión de mGBA para Windows no es adecuada para distribuirse, debido a la dispersión de las DLL que necesita para funcionar, pero es perfecta para el desarrollo. Sin embargo, si quieres distribuir tal compilación (por ejemplo, para pruebas en máquinas que no tienen el entorno MSYS2 instalado), al ejecutar `cpack -G ZIP` se preparará un archivo zip con todas las DLLs necesarias.
+
+##### Visual Studio
+
+Construir usando Visual Studio requiere una configuración igualmente complicada. Para empezar, necesitarás instalar [vcpkg](https://github.com/Microsoft/vcpkg). Después de instalar vcpkg necesitarás instalar varios paquetes adicionales:
+
+    vcpkg install ffmpeg[vpx,x264] libepoxy libpng libzip sdl2 sqlite3
+
+Toma nota de que esta instalación no soportará la codificación de video acelerada por hardware en Nvidia. Si te preocupa esto, necesitarás instalar CUDA, y luego sustituir `ffmpeg[vpx,x264,nvcodec]` en el comando anterior.
+
+También necesitarás instalar Qt. Desafortunadamente, debido a que Qt pertenece y es administrado por una empresa en problemas en lugar de una organización razonable, ya no existe un instalador de la edición de código abierto sin conexión para la última versión, por lo que deberás recurrir a un [instalador de una versión anterior](https://download.qt.io/official_releases/qt/5.12/5.12.9/qt-opensource-windows-x86-5.12.9.exe) (que quiere que crees una cuenta que de otro modo sería inútil, pero puedes omitir esto al configurar temporalmente un proxy inválido o deshabilitar la red), usa el instalador en línea (que requiere una cuenta de todos modos) o usa vcpkg para construirlo (lentamente). Ninguna de estas son buenas opciones. Si usas el instalador, querrás instalar las versiones de MSVC correspondientes. Ten en cuenta que los instaladores sin conexión no son compatibles con MSVC 2019. Para vcpkg, querrás instalarlo así, lo que llevará bastante tiempo, especialmente en computadoras de cuatro núcleos o menos:
+
+    vcpkg install qt5-base qt5-multimedia
+
+Luego, abre Visual Studio, selecciona Clonar repositorio, e ingresa `https://github.com/mgba-emu/mgba.git`. Cuando Visual Studio termine de clonar, ve a Archivo > CMake y abre el archivo CMakeLists.txt en la raíz del repositorio desplegado. Desde allí, puedes trabajar en MGBA en Visual Studio de manera similar a otros proyectos CMake de Visual Studio.
+
+#### Compilación con cadenas de herramientas (toolchain)
+
+Si tienes devkitARM (para 3DS), devkitPPC (para Wii), devkitA64 (para Switch), o vitasdk (para PS Vita), puedes usar los siguientes comandos para compilar:
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_TOOLCHAIN_FILE=../src/platform/3ds/CMakeToolchain.txt ..
+	make
+
+Reemplaza el parámetro `-DCMAKE_TOOLCHAIN_FILE` para las plataformas:
+
+- 3DS: `../src/platform/3ds/CMakeToolchain.txt`
+- Switch: `../src/platform/switch/CMakeToolchain.txt`
+- Vita: `../src/platform/psp2/CMakeToolchain.vitasdk`
+- Wii: `../src/platform/wii/CMakeToolchain.txt`
+
+### Dependencies
+
+mGBA no tiene dependencias duras, sin embargo, se requieren las siguientes dependencias opcionales para características específicas. Las características se desactivarán si no se pueden encontrar las dependencias.
+
+- Qt 5: para la interfaz gráfica. Qt Multimedia o SDL se requieren para el audio.
+- SDL: para un frontend más básico y soporte de gamepad en el frontend de Qt. Se recomienda SDL 2, pero se admite 1.2.
+- zlib y libpng: para soporte de capturas de pantalla y soporte de estados de guardado embebidos en PNG.
+- libedit: para soporte del depurador de línea de comandos.
+- ffmpeg o libav: para grabación de video, GIF, WebP y APNG.
+- libzip o zlib: para cargar ROMs almacenadas en archivos zip.
+- SQLite3: para la bases de datos de juegos.
+- libelf: para cargar ELF.
+
+SQLite3, libpng y zlib están incluidos en el emulador, por lo que no necesitan ser compilados externamente primero.
+
+Notas a pie
+---------
+
+<a name="missing">[1]</a> Las características faltantes actualmente son
+
+- OBJ window para los modos 3, 4 y 5 ([Bug #5](http://mgba.io/b/5))
+
+<a name="flashdetect">[2]</a> La detección del tamaño de la memoria flash no funciona en algunos casos. Se pueden configurar en tiempo de ejecución, pero se recomienda ingresar un bug si se encuentra un caso así.
+
+<a name="osxver">[3]</a> 10.9 sólo se necesita para la versión con Qt. Puede ser posible compilar o hacer funcionar la versión Qt en 10.7 o versiones más antigas, pero esto no está oficialmente soportado. La versión SDL funciona en 10.5, y puede funcionar en versiones anteriores.
+
+[downloads]: http://mgba.io/downloads.html
+[source]: https://github.com/mgba-emu/mgba/
+
+Copyright
+---------
+
+mGBA es Copyright © 2013 – 2021 Jeffrey Pfau. Es distribuído bajo la [licencia pública de Mozilla (Mozilla Public License) version 2.0](https://www.mozilla.org/MPL/2.0/). Una copia de la licencia está disponible en el archivo LICENSE.
+
+mGBA contiene las siguientes bibliotecas de terceros:
+
+- [inih](https://github.com/benhoyt/inih), que es copyright © 2009 - 2020 Ben Hoyt y se utiliza bajo licencia de la cláusula 3 de BSD.
+- [LZMA SDK](http://www.7-zip.org/sdk.html), la cual está en el dominio público.
+- [MurmurHash3](https://github.com/aappleby/smhasher), implementación por Austin Appleby, la cual está en el dominio público.
+- [getopt for MSVC](https://github.com/skandhurkat/Getopt-for-Visual-Studio/), la cual está en el dominio público.
+- [SQLite3](https://www.sqlite.org), la cual está en el dominio público.
+
+Si usted es un editor de juegos y desea obtener una licencia de mGBA para uso comercial, por favor envíe un correo electrónico a [licensing@mgba.io](mailto:licensing@mgba.io) para obtener más información.

README_JP.md

@@ -0,0 +1,268 @@
+mGBA
+====
+
+mGBAは、ゲームボーイアドバンスのゲームを実行するためのエミュレーターです。mGBAの目標は、既存の多くのゲームボーイアドバンスエミュレーターよりも高速かつ正確であり、他のエミュレーターにはない機能を追加することです。また、ゲームボーイおよびゲームボーイカラーのゲームもサポートしています。
+
+最新のニュースとダウンロードは、[mgba.io](https://mgba.io/)で見つけることができます。
+
+[![Build status](https://buildbot.mgba.io/badges/build-win32.svg)](https://buildbot.mgba.io)
+[![Translation status](https://hosted.weblate.org/widgets/mgba/-/svg-badge.svg)](https://hosted.weblate.org/engage/mgba)
+
+特徴
+--------
+
+- 高精度なゲームボーイアドバンスハードウェアのサポート[<sup>[1]</sup>](#missing)。
+- ゲームボーイ/ゲームボーイカラーのハードウェアサポート。
+- 高速なエミュレーション。ネットブックなどの低スペックハードウェアでもフルスピードで動作することが知られています。
+- 重量級と軽量級のフロントエンドのためのQtおよびSDLポート。
+- ローカル（同じコンピュータ）リンクケーブルのサポート。
+- フラッシュメモリサイズを含む保存タイプの検出[<sup>[2]</sup>](#flashdetect)。
+- モーションセンサーと振動機能を備えたカートリッジのサポート（ゲームコントローラーでのみ使用可能）。
+- 設定なしでもリアルタイムクロックのサポート。
+- ボクタイゲームのためのソーラーセンサーのサポート。
+- ゲームボーイカメラとゲームボーイプリンターのサポート。
+- 内蔵BIOS実装と外部BIOSファイルの読み込み機能。
+- Luaを使用したスクリプトサポート。
+- Tabキーを押し続けることでターボ/早送りサポート。
+- バッククォートを押し続けることで巻き戻し。
+- 最大10まで設定可能なフレームスキップ。
+- スクリーンショットのサポート。
+- チートコードのサポート。
+- 9つのセーブステートスロット。セーブステートはスクリーンショットとしても表示可能。
+- ビデオ、GIF、WebP、およびAPNGの録画。
+- e-Readerのサポート。
+- キーボードとゲームパッドのリマップ可能なコントロール。
+- ZIPおよび7zファイルからの読み込み。
+- IPS、UPS、およびBPSパッチのサポート。
+- コマンドラインインターフェースとGDBリモートサポートを介したゲームデバッグ、GhidraおよびIDA Proと互換性あり。
+- 設定可能なエミュレーションの巻き戻し。
+- GameSharkおよびAction Replayスナップショットの読み込みおよびエクスポートのサポート。
+- RetroArch/LibretroおよびOpenEmu用のコア。
+- [Weblate](https://hosted.weblate.org/engage/mgba)を介した複数の言語のコミュニティ提供の翻訳。
+- その他、多くの小さな機能。
+
+#### ゲームボーイマッパー
+
+以下のマッパーが完全にサポートされています：
+
+- MBC1
+- MBC1M
+- MBC2
+- MBC3
+- MBC3+RTC
+- MBC30
+- MBC5
+- MBC5+Rumble
+- MBC7
+- Wisdom Tree（非公式）
+- NT "old type" 1 and 2（非公式マルチカート）
+- NT "new type"（非公式MBC5類似）
+- Pokémon Jade/Diamond（非公式）
+- Sachen MMC1（非公式）
+
+以下のマッパーが部分的にサポートされています：
+
+- MBC6（フラッシュメモリ書き込みサポートなし）
+- MMM01
+- Pocket Cam
+- TAMA5（RTCサポート不完全）
+- HuC-1（IRサポートなし）
+- HuC-3（IRサポートなし）
+- Sachen MMC2（代替配線サポートなし）
+- BBD（ロゴ切り替えなし）
+- Hitek（ロゴ切り替えなし）
+- GGB-81（ロゴ切り替えなし）
+- Li Cheng（ロゴ切り替えなし）
+
+### 計画されている機能
+
+- ネットワーク対応のマルチプレイヤーリンクケーブルサポート。
+- Dolphin/JOYバスリンクケーブルサポート。
+- MP2kオーディオミキシング、ハードウェアより高品質のサウンド。
+- ツールアシストランのための再録サポート。
+- 包括的なデバッグスイート。
+- ワイヤレスアダプターのサポート。
+
+サポートされているプラットフォーム
+-------------------
+
+- Windows 7以降
+- OS X 10.9（Mavericks）[<sup>[3]</sup>](#osxver)以降
+- Linux
+- FreeBSD
+- Nintendo 3DS
+- Nintendo Switch
+- Wii
+- PlayStation Vita
+
+他のUnix系プラットフォーム（OpenBSDなど）も動作することが知られていますが、テストされておらず、完全にはサポートされていません。
+
+### システム要件
+
+要件は最小限です。Windows Vista以降を実行できるコンピュータであれば、エミュレーションを処理できるはずです。OpenGL 1.1以降のサポートも必要であり、シェーダーや高度な機能にはOpenGL 3.2以降が必要です。
+
+ダウンロード
+---------
+
+ダウンロードは公式ウェブサイトの[ダウンロード][downloads]セクションで見つけることができます。ソースコードは[GitHub][source]で見つけることができます。
+
+コントロール
+--------
+
+コントロールは設定メニューで設定可能です。多くのゲームコントローラーはデフォルトで自動的にマッピングされるはずです。デフォルトのキーボードコントロールは次のとおりです：
+
+- **A**：X
+- **B**：Z
+- **L**：A
+- **R**：S
+- **Start**：Enter
+- **Select**：Backspace
+
+コンパイル
+---------
+
+コンパイルにはCMake 3.1以降の使用が必要です。GCC、Clang、およびVisual Studio 2019はmGBAのコンパイルに使用できることが知られています。
+
+#### Dockerビルド
+
+ほとんどのプラットフォームでのビルドにはDockerを使用することをお勧めします。いくつかのプラットフォームでmGBAをビルドするために必要なツールチェーンと依存関係を含むいくつかのDockerイメージが提供されています。
+
+注意：Windows 10以前の古いWindowsシステムを使用している場合、DockerがVirtualBox共有フォルダーを使用して現在の`mgba`チェックアウトディレクトリをDockerイメージの作業ディレクトリに正しくマッピングするように構成する必要がある場合があります。（詳細については、issue [#1985](https://mgba.io/i/1985)を参照してください。）
+
+Dockerイメージを使用してmGBAをビルドするには、mGBAのチェックアウトのルートで次のコマンドを実行します：
+
+	docker run --rm -it -v ${PWD}:/home/mgba/src mgba/windows:w32
+
+Dockerコンテナを起動した後、ビルド成果物を含む`build-win32`ディレクトリが生成されます。他のプラットフォーム用のDockerイメージに置き換えると、対応する他のディレクトリが生成されます。Docker Hubで利用可能なDockerイメージは次のとおりです：
+
+- mgba/3ds
+- mgba/switch
+- mgba/ubuntu:xenial
+- mgba/ubuntu:bionic
+- mgba/ubuntu:focal
+- mgba/ubuntu:groovy
+- mgba/vita
+- mgba/wii
+- mgba/windows:w32
+- mgba/windows:w64
+
+ビルドプロセスを高速化したい場合は、`-e MAKEFLAGS=-jN`フラグを追加して、`N`個のCPUコアでmGBAの並列ビルドを行うことを検討してください。
+
+#### *nixビルド
+
+UnixベースのシステムでCMakeを使用してビルドするには、次のコマンドを実行することをお勧めします：
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr ..
+	make
+	sudo make install
+
+これにより、mGBAがビルドされ、`/usr/bin`および`/usr/lib`にインストールされます。インストールされている依存関係は自動的に検出され、依存関係が見つからない場合に無効になる機能は、`cmake`コマンドを実行した後に警告として表示されます。
+
+macOSを使用している場合、手順は少し異なります。homebrewパッケージマネージャーを使用していると仮定すると、依存関係を取得してビルドするための推奨コマンドは次のとおりです：
+
+	brew install cmake ffmpeg libzip qt5 sdl2 libedit lua pkg-config
+	mkdir build
+	cd build
+	cmake -DCMAKE_PREFIX_PATH=`brew --prefix qt5` ..
+	make
+
+macOSでは`make install`を実行しないでください。正しく動作しないためです。
+
+#### Windows開発者ビルド
+
+##### MSYS2
+
+Windowsでの開発用ビルドにはMSYS2を使用することをお勧めします。MSYS2の[ウェブサイト](https://msys2.github.io)に記載されているインストール手順に従ってください。32ビットバージョン（「MSYS2 MinGW 32-bit」）を実行していることを確認してください（x86_64用にビルドする場合は64ビットバージョン「MSYS2 MinGW 64-bit」を実行してください）。必要な依存関係をインストールするために次の追加コマンド（中括弧を含む）を実行します（このコマンドは1100MiB以上のパッケージをダウンロードするため、長時間かかることに注意してください）：
+
+	pacman -Sy --needed base-devel git ${MINGW_PACKAGE_PREFIX}-{cmake,ffmpeg,gcc,gdb,libelf,libepoxy,libzip,lua,pkgconf,qt5,SDL2,ntldd-git}
+
+次のコマンドを実行してソースコードをチェックアウトします：
+
+	git clone https://github.com/mgba-emu/mgba.git
+
+最後に、次のコマンドを実行してビルドします：
+
+	mkdir -p mgba/build
+	cd mgba/build
+	cmake .. -G "MSYS Makefiles"
+	make -j$(nproc --ignore=1)
+
+このWindows用mGBAビルドは、実行に必要なDLLが分散しているため、配布には適していないことに注意してください。ただし、開発には最適です。ただし、そのようなビルドを配布する必要がある場合（たとえば、MSYS2環境がインストールされていないマシンでのテスト用）、`cpack -G ZIP`を実行すると、必要なDLLをすべて含むzipファイルが準備されます。
+
+##### Visual Studio
+
+Visual Studioを使用してビルドするには、同様に複雑なセットアップが必要です。まず、[vcpkg](https://github.com/Microsoft/vcpkg)をインストールする必要があります。vcpkgをインストールした後、いくつかの追加パッケージをインストールする必要があります：
+
+    vcpkg install ffmpeg[vpx,x264] libepoxy libpng libzip lua sdl2 sqlite3
+
+このインストールでは、Nvidiaハードウェアでのハードウェアアクセラレーションビデオエンコーディングはサポートされません。これが重要な場合は、事前にCUDAをインストールし、前のコマンドに`ffmpeg[vpx,x264,nvcodec]`を置き換えます。
+
+Qtもインストールする必要があります。ただし、Qtは合理的な組織ではなく、困窮している会社によって所有および運営されているため、最新バージョンのオフラインオープンソースエディションインストーラーは存在しないため、[旧バージョンのインストーラー](https://download.qt.io/official_releases/qt/5.12/5.12.9/qt-opensource-windows-x86-5.12.9.exe)に戻る必要があります（これには無用なアカウントの作成が必要ですが、一時的に無効なプロキシを設定するか、ネットワークを無効にすることで回避できます）、オンラインインストーラーを使用する（いずれにしてもアカウントが必要です）、またはvcpkgを使用してビルドする（遅い）。これらはすべて良い選択肢ではありません。インストーラーを使用する場合は、適用可能なMSVCバージョンをインストールする必要があります。オフラインインストーラーはMSVC 2019をサポートしていないことに注意してください。vcpkgを使用する場合、次のようにインストールする必要があります。特にクアッドコア以下のコンピュータではかなりの時間がかかります：
+
+    vcpkg install qt5-base qt5-multimedia
+
+次に、Visual Studioを開き、「リポジトリのクローンを作成」を選択し、`https://github.com/mgba-emu/mgba.git`を入力します。Visual Studioがクローンを完了したら、「ファイル」>「CMake」に移動し、チェックアウトされたリポジトリのルートにあるCMakeLists.txtファイルを開きます。そこから、他のVisual Studio CMakeプロジェクトと同様にVisual StudioでmGBAを開発できます。
+
+#### ツールチェーンビルド
+
+devkitARM（3DS用）、devkitPPC（Wii用）、devkitA64（Switch用）、またはvitasdk（PS Vita用）を持っている場合は、次のコマンドを使用してビルドできます：
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_TOOLCHAIN_FILE=../src/platform/3ds/CMakeToolchain.txt ..
+	make
+
+次のプラットフォーム用に`-DCMAKE_TOOLCHAIN_FILE`パラメータを置き換えます：
+
+- 3DS：`../src/platform/3ds/CMakeToolchain.txt`
+- Switch：`../src/platform/switch/CMakeToolchain.txt`
+- Vita：`../src/platform/psp2/CMakeToolchain.vitasdk`
+- Wii：`../src/platform/wii/CMakeToolchain.txt`
+
+### 依存関係
+
+mGBAには厳密な依存関係はありませんが、特定の機能には次のオプションの依存関係が必要です。依存関係が見つからない場合、これらの機能は無効になります。
+
+- Qt 5：GUIフロントエンド用。オーディオにはQt MultimediaまたはSDLが必要です。
+- SDL：より基本的なフロントエンドおよびQtフロントエンドでのゲームパッドサポート用。SDL 2が推奨されますが、1.2もサポートされています。
+- zlibおよびlibpng：スクリーンショットサポートおよびPNG内セーブステートサポート用。
+- libedit：コマンドラインデバッガーサポート用。
+- ffmpegまたはlibav：ビデオ、GIF、WebP、およびAPNGの録画用。
+- libzipまたはzlib：zipファイルに保存されたROMの読み込み用。
+- SQLite3：ゲームデータベース用。
+- libelf：ELF読み込み用。
+- Lua：スクリプト用。
+- json-c：スクリプトの`storage` API用。
+
+SQLite3、libpng、およびzlibはエミュレーターに含まれているため、最初に外部でコンパイルする必要はありません。
+
+脚注
+---------
+
+<a name="missing">[1]</a> 現在欠けている機能は次のとおりです
+
+- モード3、4、および5のOBJウィンドウ（[バグ#5](http://mgba.io/b/5)）
+
+<a name="flashdetect">[2]</a> フラッシュメモリサイズの検出は一部のケースで機能しません。これらは実行時に構成できますが、そのようなケースに遭遇した場合はバグを報告することをお勧めします。
+
+<a name="osxver">[3]</a> 10.9はQtポートにのみ必要です。10.7またはそれ以前のバージョンでQtポートをビルドまたは実行することは可能かもしれませんが、公式にはサポートされていません。SDLポートは10.5で動作することが知られており、古いバージョンでも動作する可能性があります。
+
+[downloads]: http://mgba.io/downloads.html
+[source]: https://github.com/mgba-emu/mgba/
+
+著作権
+---------
+
+mGBAの著作権は© 2013 – 2023 Jeffrey Pfauに帰属します。これは[Mozilla Public License version 2.0](https://www.mozilla.org/MPL/2.0/)の下で配布されています。配布されたLICENSEファイルにライセンスのコピーが含まれています。
+
+mGBAには次のサードパーティライブラリが含まれています：
+
+- [inih](https://github.com/benhoyt/inih)、著作権© 2009 – 2020 Ben Hoyt、BSD 3-clauseライセンスの下で使用。
+- [LZMA SDK](http://www.7-zip.org/sdk.html)、パブリックドメイン。
+- [MurmurHash3](https://github.com/aappleby/smhasher)、Austin Applebyによる実装、パブリックドメイン。
+- [getopt for MSVC](https://github.com/skandhurkat/Getopt-for-Visual-Studio/)、パブリックドメイン。
+- [SQLite3](https://www.sqlite.org)、パブリックドメイン。
+
+ゲームパブリッシャーであり、商業利用のためにmGBAのライセンスを取得したい場合は、[licensing@mgba.io](mailto:licensing@mgba.io)までメールでお問い合わせください。

README_ZH_CN.md

@@ -0,0 +1,268 @@
+mGBA
+====
+
+mGBA 是一个运行 Game Boy Advance 游戏的模拟器。mGBA 的目标是比众多现有的 Game Boy Advance 模拟器更快、更准确，并增加其他模拟器所缺少的功能。mGBA 还支持 Game Boy 和 Game Boy Color 游戏。
+
+可在以下网址找到最新新闻和下载：[mgba.io](https://mgba.io/)。
+
+[![Build status](https://buildbot.mgba.io/badges/build-win32.svg)](https://buildbot.mgba.io)
+[![Translation status](https://hosted.weblate.org/widgets/mgba/-/svg-badge.svg)](https://hosted.weblate.org/engage/mgba)
+
+
+功能
+--------
+
+- 支持高精确的 Game Boy Advance 硬件[<sup>[1]</sup>](#missing)。
+- 支持 Game Boy/Game Boy Color 硬件。
+- 快速模拟：已知即使在低端硬件（例如上网本）上也能够全速运行。
+- 可用于重型和轻型前端的 Qt 和 SDL 移植。
+- 支持本地（同一台计算机）链接电缆。
+- 存档类型检测，即使是闪存大小也可检测[<sup>[2]</sup>](#flashdetect)。
+- 支持附带有运动传感器和振动机制的卡带（仅适用于游戏控制器）。
+- 支持实时时钟（RTC），甚至无需配置。
+- 支持《我们的太阳》系列游戏的太阳能传感器。
+- 支持 Game Boy 相机和 Game Boy 打印机。
+- 内置 BIOS 执行，并具有加载外部 BIOS 文件的功能。
+- 支持使用 Lua 编写脚本
+- 支持 Turbo/快进功能（按住 Tab 键）。
+- 支持倒带（按住反引号键）。
+- 支持跳帧，最多可配置 10 级。
+- 支持截图。
+- 支持作弊码。
+- 支持 9 个即时存档插槽。还能够以屏幕截图的形式查看即时存档。
+- 支持视频、GIF、WebP 和 APNG 录制。
+- 支持 e-Reader。
+- 可重新映射键盘和游戏手柄的控制键。
+- 支持从 ZIP 和 7z 文件中加载。
+- 支持 IPS、UPS 和 BPS 补丁。
+- 支持通过命令行界面和 GDB 远程支持进行游戏调试，兼容 Ghidra 和 IDA Pro。
+- 支持可配置的模拟倒带。
+- 支持载入和导出 GameShark 和 Action Replay 快照。
+- 适用于 RetroArch/Libretro 和 OpenEmu 的内核。
+- 社区支持的多种语言翻译 [Weblate](https://hosted.weblate.org/engage/mgba).
+- 许许多多的小玩意。
+
+#### Game Boy 映射器（mapper）
+
+完美支持以下 mapper：
+
+- MBC1
+- MBC1M
+- MBC2
+- MBC3
+- MBC3+RTC
+- MBC5
+- MBC5+振动
+- MBC7
+- Wisdom Tree（未授权）
+- NT "old type" 1 and 2 (未授权多合一卡带)
+- NT "new type" (未授权 MBC5-like)
+- Pokémon Jade/Diamond（未授权）
+- Sachen MMC1 (未授权)
+
+部分支持以下 mapper：
+
+- MBC6（缺少闪存写入支持）
+- MMM01
+- Pocket Cam
+- TAMA5（缺少 RTC 支持）
+- HuC-1（缺少 IR 支持）
+- HuC-3（缺少 IR 和 RTC 支持）
+- Sachen MMC2 (缺少备用接线支持)
+- BBD (缺少图标切换)
+- Hitek (缺少图标切换)
+- GGB-81 (缺少图标切换)
+- Li Cheng (缺少图标切换)
+
+### 计划加入的功能
+
+- 支持联网多人链接电缆。
+- 支持 Dolphin/JOY 总线链接电缆。
+- MP2k 音频混合，获得比硬件更高质量的声音。
+- 支持针对工具辅助竞速（Tool-Assisted Speedrun）的重录功能。
+- 全方位的调试套件。
+- 支持无线适配器。
+
+支持平台
+-------------------
+
+- Windows 7 或更新
+- OS X 10.9（Mavericks）[<sup>[3]</sup>](#osxver) 或更新
+- Linux
+- FreeBSD
+- Nintendo 3DS
+- Nintendo Switch
+- Wii
+- PlayStation Vita
+
+已知其他类 Unix 平台（如 OpenBSD）也可以使用，但未经测试且不完全受支持。
+
+### 系统需求
+
+系统需求很低。任何可以运行 Windows Vista 或更高版本的计算机都应该能够处理模拟机制，还需要支持 OpenGL 1.1 或更高版本。而对于着色器和高级功能，则需要支持 OpenGL 3.2 或更高版本。
+
+下载
+---------
+
+可在官方网站的[下载（Downloads）][downloads]区域找到下载地址。可在 [GitHub][source] 找到源代码。
+
+控制键位
+--------
+
+可在设置菜单中进行控制键位的配置。许多游戏控制器应该会在默认情况下自动映射。键盘的默认控制键位如下：
+
+- **A**：X
+- **B**：Z
+- **L**：A
+- **R**：S
+- **Start**：回车键
+- **Select**：退格键
+
+编译
+---------
+
+编译需要使用 CMake 3.1 或更新版本。已知 GCC , Clang 和 Visual Studio 2013 都可以编译 mGBA。
+
+#### Docker 构建
+
+对于大多数平台来说，建议使用 Docker 进行构建。我们提供了多个 Docker 映像，其中包含在多个平台上构建 mGBA 所需的工具链和依赖项。
+
+注意: 如果你是用的是 Widnows 10 之前的旧版本 Windows 系统, 你可能需要配置你的 Docker 使用 VirtualBox 共享文件夹以正确映射你当前 mGBA 检出目录到 Docker 镜像中的工作目录. 详细细节参见 issue [#1985](https://mgba.io/i/1985)
+
+要使用 Docker 映像构建 mGBA，只需在 mGBA 的签出（checkout）根目录中运行以下命令：
+
+	docker run --rm -t -v $PWD:/home/mgba/src mgba/windows:w32
+
+启动 Docker 容器之后, 此命令将生成 `build-win32` 目录, 此目录中包含编译产物。将 `mgba/windows:w32` 替换为其他平台上的 Docker 映像，会生成相应的其他目录。Docker Hub 上提供了以下 Docker 映像：
+
+- mgba/3ds
+- mgba/switch
+- mgba/ubuntu:xenial
+- mgba/ubuntu:bionic
+- mgba/ubuntu:focal
+- mgba/ubuntu:groovy
+- mgba/vita
+- mgba/wii
+- mgba/windows:w32
+- mgba/windows:w64
+
+如果你希望加速编译过程, 可以考虑添加编译选项 `-e MAKEFLAGS=-jN`, 使用 `N` 个 CPU 核心来并行构建 mGBA
+
+#### *nix 构建
+
+要在基于 Unix 的系统上使用 CMake 进行构建，推荐执行以下命令：
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr ..
+	make
+	sudo make install
+
+这些命令将构建 mGBA 并将其安装到 `/usr/bin` 和 `/usr/lib` 中。系统会自动检测已安装的依赖项，如果未找到依赖项，则会在提示找不到依赖项的情况下运行 `cmake` 命令，并显示已被禁用的功能。
+
+如果您使用的是 MacOS，则步骤略有不同。假设您使用的 homebrew 软件包管理器，建议使用以下命令来获取依赖项并进行构建：
+
+	brew install cmake ffmpeg libzip qt5 sdl2 libedit pkg-config
+	mkdir build
+	cd build
+	cmake -DCMAKE_PREFIX_PATH=`brew --prefix qt5` ..
+	make
+
+请注意，您不能在 MacOS 上执行 `make install`，因为此命令不能正常工作。
+
+#### Windows 开发者构建
+
+##### MSYS2
+
+如果要在 Windows 上进行构建，建议使用 MSYS2。请按照 MSYS2 [网站](https://msys2.github.io)上的安装步骤操作。请确保您运行的是 32 位版本的 MSYS2（“MSYS2 MinGW 32-bit”）。如果想要构建 x86_64 版本，则运行 64 位版本的 MSYS2（“MSYS2 MinGW 64-bit”） ，并执行以下额外命令（包括花括号）来安装所需的依赖项（请注意，此命令涉及下载超过 1100MiB 的包，因此会需要很长一段时间）：
+
+	pacman -Sy --needed base-devel git ${MINGW_PACKAGE_PREFIX}-{cmake,ffmpeg,gcc,gdb,libelf,libepoxy,libzip,pkgconf,qt5,SDL2,ntldd-git}
+
+运行以下命令检查源代码：
+
+	git clone https://github.com/mgba-emu/mgba.git
+
+最后运行以下命令进行构建：
+
+	mkdir -p mgba/build
+	cd mgba/build
+	cmake .. -G "MSYS Makefiles"
+	make -j$(nproc --ignore=1)
+
+请注意，此版本的 mGBA for Windows 不适合分发，因为运行此版本所需的 DLL 非常分散，但非常适合开发。但是，如果需要分发此类版本（例如用于在未安装 MSYS2 环境的计算机上进行测试），请运行 `cpack-G ZIP`，准备一个包含所有必要 DLL 的压缩文件。
+
+##### Visual Studio
+
+使用 Visual Studio 进行构建需要同样复杂的设置。首先需要安装 [vcpkg](https://github.com/Microsoft/vcpkg)。安装 vcpkg 后，还需要安装数个额外的软件包：
+
+    vcpkg install ffmpeg[vpx,x264] libepoxy libpng libzip sdl2 sqlite3
+
+请注意，此安装将不支持 Nvidia 硬件上的硬件加速视频编码。如果对此非常在意，则需要预先安装 CUDA，然后用 `ffmpeg[vpx,x264,nvcodec]` 替换前面命令中的 `ffmpeg[vpx,x264]`。
+
+您还需要安装 Qt。但不幸的是，由于 Qt 已被一家境况不佳的公司而不是合理的组织所拥有并运营，所以不再存在针对最新版本的离线开源版本安装程序，需要退回到[旧版本的安装程序](https://download.qt.io/official_releases/qt/5.12/5.12.9/qt-opensource-windows-x86-5.12.9.exe) （会要求创建一个原本已无用的帐号，但可以通过临时设置无效代理或以其他方式禁用网络来绕过这一机制。）、使用在线安装程序（无论如何都需要一个帐号），或使用 vcpkg 进行构建（速度很慢）。这些都不是很好的选择。需要针对安装程序安装适用的 MSVC 版本。请注意，离线安装程序不支持 MSVC 2019。若使用 vcpkg，您需要花费相当一段时间将其安装，尤其是在四核或更少内核的计算机上花费时间更久：
+
+    vcpkg install qt5-base qt5-multimedia
+
+下一步打开 Visual Studio，选择“克隆仓库”, 输入 `https://github.com/mgba-emu/mgba.git`。在 Visual Studio 完成克隆后，转到“文件”>“CMake”，然后打开已签出（checked out）仓库的 CMakeLists.txt 文件。在此基础上便可像其他 Visual Studio CMake 项目一样在 Visual Studio 中开发 mGBA。
+
+#### 工具链构建
+
+如果您拥有 devkitARM（3DS）、devkitPPC（Wii）、devkitA64（Switch）或 vitasdk（PS Vita），您可以使用以下命令进行构建：
+
+	mkdir build
+	cd build
+	cmake -DCMAKE_TOOLCHAIN_FILE=../src/platform/3ds/CMakeToolchain.txt ..
+	make
+
+将 `-DCMAKE_TOOLCHAIN_FILE` 参数替换为以下不同平台的参数：
+
+- 3DS：`../src/platform/3ds/CMakeToolchain.txt`
+- Switch：`../src/platform/switch/CMakeToolchain.txt`
+- Vita：`../src/platform/psp2/CMakeToolchain.vitasdk`
+- Wii：`../src/platform/wii/CMakeToolchain.txt`
+
+### 依赖项
+
+mGBA 没有硬性的依赖项，但是特定功能需要以下可选的依赖项。如果找不到依赖项，则这些可选功能将会被禁用。
+
+- Qt 5：GUI 前端的所需依赖项。音频需要 Qt Multimedia 或 SDL。
+- SDL：更基本的前端以及在 Qt 前端中支持游戏手柄的所需依赖项。推荐使用 SDL 2、但也支持 1.2。
+- zlib 和 libpng：截图与 PNG 即时存档支持的所需依赖项
+- libedit：命令行调试器的所需依赖项
+- ffmpeg 或 libav：录制视频、GIF、WebP 和 APNG 的所需依赖项
+- libzip 或 zlib：载入储存在 ZIP 文件中的 ROM 的所需依赖项。
+- SQLite3：游戏数据库的所需依赖项
+- libelf：ELF 载入的所需依赖项
+- Lua: 脚本支持
+- json-c: 脚本 `storage` API 支持
+
+SQLite3、libpng 以及 zlib 已包含在模拟器中，因此不需要先对这些依赖项进行外部编译。
+
+脚注
+---------
+
+<a name="missing">[1]</a> 目前缺失的功能有
+
+- 模式 3、4 和 5 的 OBJ 窗口 ([Bug #5](http://mgba.io/b/5))
+
+<a name="flashdetect">[2]</a> 闪存大小检测在某些情况下不起作用。 这些可以在运行时中进行配置，但如果遇到此类情况，建议提交错误。
+
+<a name="osxver">[3]</a> 仅 Qt 移植需要 10.9。应该可以在 10.7 或更早版本上构建或运行 Qt 移植，但这类操作不受官方支持。已知 SDL 移植可以在 10.5 上运行，并且可能能够在旧版本上运行。
+
+[downloads]: http://mgba.io/downloads.html
+[source]: https://github.com/mgba-emu/mgba/
+
+版权
+---------
+
+mGBA 版权 © 2013 – 2023 Jeffrey Pfau。基于 [Mozilla 公共许可证版本 2.0](https://www.mozilla.org/MPL/2.0/) 许可证分发。分发的 LICENSE 文件中提供了许可证的副本。
+
+mGBA 包含以下第三方库：
+
+- [inih](https://github.com/benhoyt/inih)：版权 © 2009 – 2020 Ben Hoyt，基于 BSD 3-clause 许可证使用。
+- [LZMA SDK](http://www.7-zip.org/sdk.html)：属公有领域使用。
+- [MurmurHash3](https://github.com/aappleby/smhasher)：由 Austin Appleby 实施，属公有领域使用。
+- [getopt for MSVC](https://github.com/skandhurkat/Getopt-for-Visual-Studio/)：属公有领域使用。
+- [SQLite3](https://www.sqlite.org)：属公有领域使用。
+
+如果您是游戏发行商，并希望获得 mGBA 用于商业用途的许可，请发送电子邮件到 [licensing@mgba.io](mailto:licensing@mgba.io) 获取更多信息。

cinema/.gitignore

@@ -0,0 +1 @@
+*.sav

cinema/gb/acid/config.ini

@@ -0,0 +1,6 @@
+[testinfo]
+skip=15
+frames=1
+
+[ports.cinema]
+sgb.borders=0

cinema/gb/blargg/cgb_sound/02-len ctr/config.ini

@@ -0,0 +1,2 @@
+[testinfo]
+skip=600

cinema/gb/blargg/cgb_sound/03-trigger/config.ini

@@ -0,0 +1,2 @@
+[testinfo]
+skip=1080

cinema/gb/blargg/config.ini

@@ -0,0 +1,3 @@
+[testinfo]
+skip=360
+frames=1

cinema/gb/blargg/cpu_instrs/03-op sp,hl/config.ini

@@ -0,0 +1,3 @@
+[testinfo]
+skip=600
+fail=1

cinema/gb/blargg/cpu_instrs/10-bit ops/config.ini

@@ -0,0 +1,2 @@
+[testinfo]
+skip=600

cinema/gb/blargg/cpu_instrs/11-op a,(hl)/config.ini

@@ -0,0 +1,2 @@
+[testinfo]
+skip=600

cinema/gb/blargg/dmg_sound/02-len ctr/config.ini

@@ -0,0 +1,2 @@
+[testinfo]
+skip=600

cinema/gb/blargg/dmg_sound/03-trigger/config.ini

@@ -0,0 +1,2 @@
+[testinfo]
+skip=1080

cinema/gb/blargg/dmg_sound/10-wave trigger while on/config.ini

@@ -0,0 +1,2 @@
+[testinfo]
+fail=1