README_ES.md (view raw)
1mGBA
2====
3
4mGBA 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.
5
6Las noticias actualizadas y las descargas se encuentran en [mgba.io](https://mgba.io/).
7
8[](https://travis-ci.org/mgba-emu/mgba)
9
10Características
11--------
12
13- Soporte de hardware Game Boy Advance altamente preciso[<sup>[1]</sup>](#missing).
14- Soporte de hardware Game Boy/Game Boy Color.
15- Emulación rápida. Corre a velocidad completa en hardware de gama baja, como los netbooks.
16- Interfaz gráfica en SDL y Qt.
17- Soporte para cable de enlace (link cable) local (en la misma computadora).
18- Detección de tipos de guardado, incluso para tamaños de memoria flash[<sup>[2]</sup>](#flashdetect).
19- Soporte para cartuchos con sensores de movimiento y vibración (solo usable con mandos).
20- Soporte para reloj en tiempo real, incluso sin configuración.
21- Soporte para sensor solar, para juegos Boktai.
22- Soporta la Cámara y la Impresora Game Boy.
23- Implementación interna de BIOS, y opción para usar una BIOS externa.
24- Modo turbo/avance rápido al mantener Tab presionado.
25- Retroceder al presionar "`".
26- Salto de cuadros de hasta 10 cuadros por vez.
27- Captura de pantalla (pantallazo).
28- Soporta códigos de truco.
29- 9 espacios para estados de guardado. Estos tambien pueden ser vistos como pantallazos.
30- Grabación de video, GIF, WebP, y APNG.
31- Soporte para e-Reader.
32- Controles modificables para teclado y mandos.
33- Cargar desde archivos ZIP y 7z.
34- Soporta parches IPS, UPS y BPS.
35- Depuración de juegos a través de una interfaz de línea de comandos y soporte remoto GDB, compatible con IDA Pro.
36- Retroceso configurable.
37- Soporte para cargar y exportar instantáneas de GameShark y Action Replay.
38- Núcleos disponibles para RetroArch/Libretro y OpenEmu.
39- Otras cosas más pequeñas.
40
41#### Mappers (controladores de memoria) soportados
42
43Estos mappers tienen soporte completo:
44
45- MBC1
46- MBC1M
47- MBC2
48- MBC3
49- MBC3+RTC
50- MBC5
51- MBC5+Rumble
52- MBC7
53- Wisdom Tree (sin licencia)
54- Pokémon Jade/Diamond (sin licencia)
55- BBD (sin licencia, similar a MBC5)
56- Hitek (sin licencia, similar a MBC5)
57
58Estos mappers tienen soporte parcial:
59
60- MBC6 (sin soporte para escribir a la memoria flash)
61- MMM01
62- Pocket Cam
63- TAMA5 (sin soporte para RTC)
64- HuC-1 (sin soporte para IR)
65- HuC-3 (sin soporte para RTC e IR)
66
67### Características planeadas
68
69- Soporte para cable de enlace por red.
70- Soporte para cable de enlace por Joybus para Dolphin.
71- Mezcla de audio MP2k, para mayor calidad de sonido.
72- Soporte de regrabación para speedruns asistidos por herramientas (TAS).
73- Soporte de Lua para prog.
74- Un completo paquete de depuración.
75- Compatibilidad con adaptadores inalámbricos.
76
77Plataformas soportadas
78-------------------
79
80- Windows Vista o más reciente
81- OS X 10.8 (Mountain Lion)[<sup>[3]</sup>](#osxver) o más reciente
82- Linux
83- FreeBSD
84- Nintendo 3DS
85- Nintendo Switch
86- Wii
87- PlayStation Vita
88
89Otras plataformas Unix-like, como OpenBSD, funcionan también, pero no han sido probadas.
90
91### Requisitos de sistema
92
93Los 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.
94
95Descargas
96---------
97
98Las 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].
99
100Controles
101--------
102
103Los 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:
104
105- **A**: X
106- **B**: Z
107- **L**: A
108- **R**: S
109- **Start**: Entrar
110- **Select**: Retroceso
111
112Compilar
113---------
114
115La 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.
116
117#### Compilación por Docker
118
119Recomendamos 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.
120
121Para 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:
122
123 docker run --rm -t -v $PWD:/home/mgba/src mgba/windows:w32
124
125Esto 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:
126
127- mgba/3ds
128- mgba/switch
129- mgba/ubuntu:xenial
130- mgba/ubuntu:bionic
131- mgba/ubuntu:focal
132- mgba/ubuntu:groovy
133- mgba/vita
134- mgba/wii
135- mgba/windows:w32
136- mgba/windows:w64
137
138#### Compilación en *nix
139
140Si quieres usar CMake para compilar mGBA en un sistema Unix-like, recomendamos los siguientes comandos:
141
142 mkdir build
143 cd build
144 cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr ..
145 make
146 sudo make install
147
148Esto 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.
149
150Si 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:
151
152 brew install cmake ffmpeg libzip qt5 sdl2 libedit pkg-config
153 mkdir build
154 cd build
155 cmake -DCMAKE_PREFIX_PATH=`brew --prefix qt5` ..
156 make
157
158Toma nota de que no debes usar `make install` en macOS, ya que no funcionará correctamente.
159
160#### Compilación en Windows para desarrolladores
161
162##### MSYS2
163
164Para 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)
165
166Para compilar en x86 (32 bits):
167
168 pacman -Sy --needed base-devel git mingw-w64-i686-{cmake,ffmpeg,gcc,gdb,libelf,libepoxy,libzip,pkg-config,qt5,SDL2,ntldd-git}
169
170Para compilar en x86_64 (64 bits):
171
172 pacman -Sy --needed base-devel git mingw-w64-x86_64-{cmake,ffmpeg,gcc,gdb,libelf,libepoxy,libzip,pkg-config,qt5,SDL2,ntldd-git}
173
174Despliega (haz check out en) el código fuente ejecutando este comando:
175
176 git clone https://github.com/mgba-emu/mgba.git
177
178Luego, compílalo usando estos comandos:
179
180 cd mgba
181 mkdir build
182 cd build
183 cmake .. -G "MSYS Makefiles"
184 make
185
186Ten 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.
187
188##### Visual Studio
189
190Construir 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:
191
192 vcpkg install ffmpeg[vpx,x264] libepoxy libpng libzip sdl2 sqlite3
193
194Toma 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.
195
196Tambié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:
197
198 vcpkg install qt5-base qt5-multimedia
199
200Luego, 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.
201
202#### Compilación con cadenas de herramientas (toolchain)
203
204Si tienes devkitARM (para 3DS), devkitPPC (para Wii), devkitA64 (para Switch), o vitasdk (para PS Vita), puedes usar los siguientes comandos para compilar:
205
206 mkdir build
207 cd build
208 cmake -DCMAKE_TOOLCHAIN_FILE=../src/platform/3ds/CMakeToolchain.txt ..
209 make
210
211Reemplaza el parámetro `-DCMAKE_TOOLCHAIN_FILE` para las plataformas:
212
213- 3DS: `../src/platform/3ds/CMakeToolchain.txt`
214- Switch: `../src/platform/switch/CMakeToolchain.txt`
215- Vita: `../src/platform/psp2/CMakeToolchain.vitasdk`
216- Wii: `../src/platform/wii/CMakeToolchain.txt`
217
218### Dependencies
219
220mGBA 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.
221
222- Qt 5: para la interfaz gráfica. Qt Multimedia o SDL se requieren para el audio.
223- 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.
224- zlib y libpng: para soporte de capturas de pantalla y soporte de estados de guardado embebidos en PNG.
225- libedit: para soporte del depurador de línea de comandos.
226- ffmpeg o libav: para grabación de video, GIF, WebP y APNG.
227- libzip o zlib: para cargar ROMs almacenadas en archivos zip.
228- SQLite3: para la bases de datos de juegos.
229- libelf: para cargar ELF.
230
231SQLite3, libpng y zlib están incluidos en el emulador, por lo que no necesitan ser compilados externamente primero.
232
233Notas a pie
234---------
235
236<a name="missing">[1]</a> Las características faltantes actualmente son
237
238- OBJ window para los modos 3, 4 y 5 ([Bug #5](http://mgba.io/b/5))
239
240<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í.
241
242<a name="osxver">[3]</a> 10.8 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.
243
244[downloads]: http://mgba.io/downloads.html
245[source]: https://github.com/mgba-emu/mgba/
246
247Copyright
248---------
249
250mGBA es Copyright © 2013 – 2020 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.
251
252mGBA contiene las siguientes bibliotecas de terceros:
253
254- [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.
255- [blip-buf](https://code.google.com/archive/p/blip-buf), que es copyright © 2003 - 2009 Shay Green y se usa bajo LGPL.
256- [LZMA SDK](http://www.7-zip.org/sdk.html), la cual está en el dominio público.
257- [MurmurHash3](https://github.com/aappleby/smhasher), implementación por Austin Appleby, la cual está en el dominio público.
258- [getopt for MSVC](https://github.com/skandhurkat/Getopt-for-Visual-Studio/), la cual está en el dominio público.
259- [SQLite3](https://www.sqlite.org), la cual está en el dominio público.
260
261Si 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.