Manualinux
http://www.nvu.com http://www.gimp.org InicioPresentaciónActualizacionesManualesDescargasNoticiasAgradecimientoEnlaces

Entornos GráficosAplicaciones

DesarrolloEmuladoresInternetJuegosMultimediaSistema

Emuladores - Gens/GSEmuladores - ScummVM

Emuladores - MAME




Emuladores - MAME




Copyright

Copyright © José Luis Lara Carrascal  2010-2024   http://manualinux.es



Sumario

Introducción
Preliminares
MAME
Iniciamos MAME
QMC2
Iniciamos QMC2
Funciones principales del teclado
Enlaces




Introducción  

MAME es uno de los emuladores de juegos de máquinas recreativas más famosos que existen. En este manual, además de tratar la instalación desde código fuente del emulador, también se incluye la de QMC2, una interfaz gráfica para MAME escrita en C++ y Qt. Desde el 28-11-2018, el manual se ha configurado para poder ejecutar MAME sin aplicación auxiliar, utilizando la interfaz gráfica de usuario que se muestra cuando lo ejecutamos solo.



Preliminares  

1) Comprobar que la ruta de instalación de los binarios del programa la tenemos en nuestro PATH


Abrimos una ventana de terminal y ejecutamos el siguiente comando:

[jose@Fedora-18 ~]$ echo $PATH
/usr/lib/qt-3.3/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:/home/jose/bin

Si no aparece entre las rutas mostradas el directorio /usr/games, abrimos un editor de texto y añadimos lo siguiente:

#!/bin/sh

export PATH=/usr/games:$PATH

Lo guardamos con el nombre variables.sh, y lo instalamos en /etc/profile.d.

$ su -c "install -m755 variables.sh /etc/profile.d"

Tenemos que cerrar el emulador de terminal y volverlo a abrir para que la variable de entorno aplicada sea efectiva. Es conveniente guardar una copia de este script para posteriores instalaciones de nuestro sistema, teniendo en cuenta que es el que se va a utilizar a partir de ahora en todos los manuales de esta web, para establecer variables de entorno globales, excepto en aquellas que sólo afectan al usuario, en las que se utilizará el archivo de configuración personal, ~/.bashrc.

La ventaja de utilizar el directorio /etc/profile.d es que es común a todas las distribuciones y nos evita tener que editar otros archivos del sistema como por ejemplo, /etc/profile.



MAME  

Instalación

Dependencias

Herramientas de Compilación


Entre paréntesis la versión con la que se ha compilado MAME para la elaboración de este documento.

* GCC - (13.2.0) o Clang - (18.1.2)
* Make - (4.4.1)
* Pkg-config - (0.29.2)
* Gettext - (0.22.5)

Librerías de Desarrollo

* Xorg - (7.7 / xorg-server 21.1.11)
   LibX11 - (1.8.8)
   LibXext - (1.3.6)
   LibXi - (1.8.1)
   LibXinerama - (1.1.5)
* ALSA - (1.2.11)
* Fontconfig - (2.15.0)
* Libglvnd - (1.7.0)
* Qt5 - (5.15.13)
* SDL - (2.30.1)
* SDL_ttf - (2.22.0)

Intérpretes de Lenguaje de Programación

* Python - (3.12.2)

Aplicaciones

* Sphinx - (7.2.6) [1]
* Wget - (1.21.4) [2]

[1] Requerido para poder crear la documentación en formato HTML y página de manual del programa.
[2] Requerido para poder descargarnos los iconos del archivo desktop desde internet.



Descarga

mame-0.264.tar.xz

Firma Digital  Clave pública PGP

mame-0.264.tar.xz.asc

Verificar la firma digital del paquete

$ gpg --import manualinux.asc
$ gpg --verify mame-0.264.tar.xz.asc mame-0.264.tar.xz

Optimizaciones

$ export {C,CXX}FLAGS='-O3 -march=znver3 -mtune=znver3'

Donde pone znver3 se indica el procesador respectivo de cada sistema seleccionándolo de la siguiente tabla:
Nota informativa sobre las optimizaciones para GCC
* La opción '-march=' establece el procesador mínimo con el que funcionará el programa compilado, la opción '-mtune=' el procesador específico para el que será optimizado. 

* Los valores separados por comas, son equivalentes, es decir, que lo mismo da poner '-march=k8' que '-march=athlon64'.

* En versiones de GCC 3.2 e inferiores se utiliza la opción '-mcpu=' en lugar de '-mtune='.
Nota informativa sobre las optimizaciones para Clang
* La opción '-mtune=' está soportada a partir de la versión 3.4 de Clang.

* Los valores de color azul no son compatibles con Clang.

* Las filas con el fondo de color amarillo son valores exclusivos de Clang y, por lo tanto, no son aplicables con GCC.
Valores CPU
Genéricos
Intel
AMD

Optimizaciones adicionales

Optimizaciones adicionales
GCC
Graphite
$ export {C,CXX}FLAGS+=' -ftree-loop-linear -floop-strip-mine -floop-block'
IPA
$ export {C,CXX}FLAGS+=' -fipa-pta'
Clang
Polly
$ export {C,CXX}FLAGS+=' -O3 -mllvm -polly -mllvm -polly-vectorizer=stripmine'
OpenMP
$ export LDFLAGS+=" -L$(llvm-config --libdir) -lomp"

Parámetros adicionales

Establecer la ruta de búsqueda de directorios de librerías en sistemas de 64 bits multiarquitectura
$ export LDFLAGS+=" -L/usr/lib64 -L/usr/local/lib64 -L/opt/gcc13/lib64"
Cada usuario tendrá que establecer la ruta de búsqueda de directorios, en función de la distribución que utilice.

Establecer el uso de enlazador dinámico para Mold
$ export LDFLAGS+=' -fuse-ld=mold'

Establecer la variable de entorno de uso de compilador para Clang
$ export CC=clang CXX=clang++

Extracción y Compilación  Bloc de Notas Información general sobre el uso de los comandos

$ tar Jxvf mame-0.264.tar.xz
$ cd mame-0.264
$ make TOOLS=1 NOWERROR=1 PTR64=1

Explicación de los comandos

TOOLS=1 : Activa la compilación de las utilidades de MAME.

NOWERROR=1 : Impide que los avisos mostrados por el compilador sean tratados como errores.

PTR64=1 : Parámetro requerido en sistemas de 64 bits.

Parámetros de compilación opcionales

CC="${CC}" {CXX,LD}="${CXX}" : Si vamos a compilar el paquete con Clang, sincronizamos la variable de entorno del proceso de compilación con la variable de entorno establecida en el manual.

VERBOSE=1 : Muestra más información en el proceso de compilación.

BIGENDIAN=1 : En sistemas GNU/Linux instalados en ordenadores MAC con procesadores PowerPC, añadir este parámetro.

OPENMP=1
: Activa el soporte de ejecución multiproceso de MAME con OpenMP. Sólo es funcional si nuestro procesador es multinúcleo.

-j$(nproc) : Establece el número de procesos de compilación en paralelo, en función del número de núcleos e hilos de nuestro procesador, tomando como referencia la información mostrada por el sistema con el comando correspondiente. Si nuestro procesador es mononúcleo de un solo hilo, no añadir esta opción.

Crear la documentación del programa en formato HTML y página de manual con Sphinx (opcional)

$ cd docs; make html man; cd ..

Instalación como root

$ su
# install -dm755 /usr/{games,share/doc/mame-0.264,share/man/man1,share/mame/language/Spanish}
# mv split{,m}
# for i in castool imgtool chdman floptool jedutil ldverify mame \
nltool nlwav regrep romcmp srcclean unidasm splitm pngcmp testkeys ; do \
install -sm755 $i /usr/games ; \
done
# install -m644 language/Spanish/strings.mo /usr/share/mame/language/Spanish
# cp -rf --no-preserve=ownership docs/build/html /usr/share/doc/mame-0.264
# install -m644 docs/man/{castool,chdman,floptool,\
imgtool,jedutil,ldverify,romcmp}.1 docs/build/man/MAME.1 /usr/share/man/man1

Descarga e instalación de los iconos del archivo desktop desde internet como root (opcional)

# for i in /usr/share/icons/hicolor ; do \
install -dm755 $i/{16x16,24x24,32x32,48x48,64x64,128x128,256x256}/apps ; \
wget -c http://icons.iconarchive.com/icons/papirus-team/\
papirus-apps/256/mame-icon.png -O $i/256x256/apps/mame.png ; \
wget -c http://icons.iconarchive.com/icons/papirus-team/\
papirus-apps/128/mame-icon.png -O $i/128x128/apps/mame.png ; \
wget -c http://icons.iconarchive.com/icons/papirus-team/\
papirus-apps/64/mame-icon.png -O $i/64x64/apps/mame.png ; \
wget -c http://icons.iconarchive.com/icons/papirus-team/\
papirus-apps/48/mame-icon.png -O $i/48x48/apps/mame.png ; \
wget -c http://icons.iconarchive.com/icons/papirus-team/\
papirus-apps/32/mame-icon.png -O $i/32x32/apps/mame.png ; \
wget -c http://icons.iconarchive.com/icons/papirus-team/\
papirus-apps/24/mame-icon.png -O $i/24x24/apps/mame.png ; \
wget -c http://icons.iconarchive.com/icons/papirus-team/\
papirus-apps/16/mame-icon.png -O $i/16x16/apps/mame.png ; \
gtk-update-icon-cache -tf $i &> /dev/null ; \
done

Explicación de los comandos

install -dm755 /usr/{games,share/doc/mame-0.264,share/man/man1,share/mame/language/Spanish} : Crea los directorios de instalación de los binarios ejecutables, la traducción al español del programa, la documentación de MAME y las páginas de manual.

mv split{,m} : Renombra el ejecutable split a splitm, para evitar conflictos de ejecución con el ejecutable split de las GNU Coreutils.

for i in castool imgtool chdman floptool jedutil ldverify mame \
nltool nlwav regrep romcmp srcclean unidasm testkeys splitm pngcmp ; do \
install -sm755 $i /usr/games ; \
done : Instala los ejecutables en el directorio /usr/games con los comandos for e install, eliminando los símbolos innecesarios para su ejecución.

install -m644 language/Spanish/strings.mo /usr/share/mame/language/Spanish : Instala la traducción al español del programa en el directorio correspondiente. El directorio padre (/usr/share/mame/language) lo tendremos que seleccionar desde la interfaz del mismo, para que se cargue correctamente la traducción al español. También podemos ejecutar MAME por primera vez, cerrarlo y editar de forma manual, el archivo de configuración, ~/.mame/mame.ini y añadir la ruta correspondiente en la siguiente línea (lo que está en rojo):

#
# CORE SEARCH PATH OPTIONS
#
homepath                  .
rompath                   roms;/home/jose/Juegos/ROMS
hashpath                  hash
samplepath                samples
artpath                   artwork
ctrlrpath                 ctrlr
inipath                   $HOME/.mame;.;ini
fontpath                  .
cheatpath                 cheat
crosshairpath             crosshair
pluginspath               plugins
languagepath              /usr/share/mame/language
swpath                    software

Nos vamos más abajo, por la línea 192, y establecemos de forma definitiva el idioma español para la interfaz del programa.

# CORE MISC OPTIONS
#
drc                       1
drc_use_c                 0
drc_log_uml               0
drc_log_native            0
bios                     
cheat                     0
skip_gameinfo             0
uifont                    default
ui                        cabinet
ramsize                  
confirm_quit              0
ui_mouse                  1
language                  Spanish
nvram_save                1

cp -rf --no-preserve=ownership docs/build/html /usr/share/doc/mame-0.264 : Copia el directorio íntegro de la documentación del programa en formato HTML que hemos creado con Sphinx al directorio /usr/share/doc/mame-0.264.

install -m644 docs/man/{castool,chdman,floptool,\
imgtool,jedutil,ldverify,romcmp}.1 docs/build/man/MAME.1 /usr/share/man/man1 : Instala las páginas de manual de MAME y de los programas adicionales que hemos instalado con el mismo.

for i in /usr/share/icons/hicolor ... : Descarga e instala los iconos del archivo desktop del programa. 

Ejecutables instalados
castool, imgtool, chdman, floptool, jedutil, ldverify, mame, nltool, nlwav, regrep, romcmp, srcclean, unidasm, splitm, pngcmp y testkeys.

Directorios como el de plugins, artwork, bgfx, etc. no los incluyo en la instalación porque el usuario los puede copiar a su directorio personal o al directorio en el que decida tener ubicados estos directorios, que contienen gran cantidad de material para utilizar con MAME. Como no son directorios requeridos para poder ejecutar los juegos, no los considero importantes en la instalación del programa.

Comprimir los ejecutables más grandes con UPX (opcional)

# upx /usr/games/mame

Estadísticas de Compresión de UPX
Ejecutable
Tamaño original Tamaño comprimido Ratio de compresión
mame 335,7 MB 93,1 MB 27,72 %
Espacio ahorrado en disco: 242,6 MB

Creación del archivo mame.desktop

Para que MAME sea detectado por los menús de entornos gráficos como XFce 4 o paneles como LXPanel o Fbpanel, creamos el correspondiente archivo desktop con cat o con un editor de texto:

# cat > mame.desktop << "EOF"
[Desktop Entry]
Name=MAME
GenericName=MAME
Comment=Un emulador de máquinas recreativas
Exec=mame
Icon=mame
Categories=Application;Game;Emulator
Type=Application
EOF

Luego, lo instalamos en /usr/share/applications. La desinstalación y respaldo de este archivo viene incluida en los scripts correspondientes proporcionados en este manual. 

# install -dm755 /usr/share/applications
# install -m644 mame.desktop /usr/share/applications

Estadísticas de Compilación e Instalación de MAME

Estadísticas de Compilación e Instalación de MAME
CPU AMD Ryzen 5 5500
MHz 3593.250 (BoostMax=4457.000)
RAM 32 GB
Tarjeta gráfica AMD Radeon RX 580 2048SP
Controlador de gráficos AMDGPU 23.0.0
Sistema de archivos XFS
Versión del Kernel 6.8.1-ml SMP PREEMPT_DYNAMIC x86_64
Modo de frecuencia de la CPU powersave (balance performance)
Planificador de CPU BMQ
Versión de Glibc 2.39
Enlazador dinámico Mold 2.30.0
Compilador GCC 13.2.0 + Ccache 4.9.1
Parámetros de optimización -03 -march=znver3 -mtune=znver3 -ftree-loop-linear -floop-strip-mine -floop-block -fipa-pta -fpch-preprocess
Parámetros de Ccache adicionales CCACHE_NOCPP2=true
Parámetros de compilación VERBOSE=1 -j12
Ocupación de espacio en disco del proceso de compilación 3,8 GB
Tiempo de compilación 28' 46"
Archivos instalados 247
Mostrar/Ocultar la lista de archivos instalados
Ocupación de espacio en disco 369,7 MB (127,1 MB con UPX)

Consumo inicial de CPU y RAM de MAME

Consumo inicial de CPU y RAM de MAME
Programa
CPU RAM
mame 0,7 % 758,0 MB (965,9 MB con UPX)
Para medir el consumo de CPU se utiliza el programa top, y para medir el consumo de RAM se utiliza el script de Python, ps_mem.py, creado por Pádraig Brady, que podemos encontrar en este enlace.

Directorio de configuración personal

~/.mame Es el directorio de configuración personal de MAME en nuestro home. La ubicación del resto de directorios, los puede configurar el usuario a su gusto desde la interfaz de MAME.

Desinstalación como root

1) MODO TRADICIONAL

************************

2) MODO MANUALINUX

mame-0.264-scripts.tar.gz

$ su
# tar zxvf mame-0.264-scripts.tar.gz
# cd mame-0.264-scripts
# ./Desinstalar_mame-0.264

Copia de Seguridad como root

Con este otro script creamos una copia de seguridad de los binarios compilados, recreando la estructura de directorios de los mismos en un directorio de copias de seguridad (copibin) que se crea en el directorio /var. Cuando se haya creado el paquete comprimido de los binarios podemos copiarlo como usuario a nuestro home y borrar el que ha creado el script de respaldo, teniendo en cuenta que si queremos volver a restaurar la copia, tendremos que volver a copiarlo al lugar donde se ha creado.

$ su
# tar zxvf mame-0.264-scripts.tar.gz
# cd mame-0.264-scripts
# ./Respaldar_mame-0.264

Restaurar la Copia de Seguridad como root

Y con este otro script (que se copia de forma automática cuando creamos la copia de respaldo del programa) restauramos la copia de seguridad como root cuando resulte necesario.

$ su
# cd /var/copibin/restaurar_copias
# ./Restaurar_mame-0.264



Iniciamos MAME  

Sólo nos queda teclear en una terminal o en un lanzador el comando mame, y el programa aparecerá en la pantalla.


Captura MAME - 1


Captura MAME - 2


Captura MAME - 2




QMC2  

Interfaz gráfica para MAME escrita en C++ y Qt, bastante más completa y estable que la anterior tratada en este manual, GMAMEUI.

Instalación

Dependencias

Herramientas de Compilación


Entre paréntesis la versión con la que se ha compilado QMC2 para la elaboración de este documento.

* GCC - (13.2.0)
* Make - (4.4.1)

Librerías de Desarrollo

* Xorg - (7.7 / xorg-server 21.1.9)
* Qt5 - (5.15.11)
* QtWebKit - (5.212.0 Alpha 4)
* SDL - (2.28.4)

Aplicaciones

MAME - (0.264)
Rsync - (3.2.7)



Descarga

qmc2-mame-fe-0.243.tar.gz

Optimizaciones

Optimizaciones adicionales

Optimizaciones adicionales
Graphite
$ export {C,CXX}FLAGS+=' -ftree-loop-linear -floop-strip-mine -floop-block'

Parámetros adicionales

Establecer la ruta de búsqueda de directorios de librerías en sistemas de 64 bits multiarquitectura
$ export LDFLAGS+=" -L/usr/lib64 -L/usr/local/lib64 -L/opt/gcc13/lib64"
Cada usuario tendrá que establecer la ruta de búsqueda de directorios, en función de la distribución que utilice.

Establecer el uso de enlazador dinámico para Mold
$ export LDFLAGS+=' -fuse-ld=mold'

Extracción y Configuración  Bloc de Notas Información general sobre el uso de los comandos

$ tar zxvf qmc2-mame-fe-0.243.tar.gz
$ cd qmc2-mame-fe-0.243
$ export PATH=$(pkg-config --variable=host_bins Qt5Core):$PATH
$ make {CC,CXX}_FLAGS='${CXXFLAGS}' L_FLAGS='${LDFLAGS}' configure
$ sed -i 's:-O2 ::g' Makefile.qmake

Explicación de los comandos

export PATH=$(pkg-config --variable=host_bins Qt5Core):$PATH : Si hemos instalado Qt5 en un directorio no habitual, le indicamos la ruta correspondiente a los binarios ejecutables del mismo.

{CC,CXX}_FLAGS='${CXXFLAGS}' L_FLAGS='${LDFLAGS}' : Adapta las variables de entorno de optimización y LDFLAGS establecidas en el manual, a las utilizadas en el proceso de compilación del paquete.

configure : Es el comando de configuración del paquete.

sed -i 's:-O2 ::g' Makefile.qmake : Borra las referencias existentes en el archivo Makefile.qmake creado al nivel de optimización utilizado por defecto (-O2), para evitar una duplicidad de niveles de optimización aplicados en el proceso de compilación, y sea este último el aplicado por el compilador.

Compilación

$ make

Parámetros de compilación opcionales

Instalación como root

$ su -c "make PREFIX=/usr install"

Explicación de los comandos

PREFIX=/usr : Instala el programa en el directorio principal /usr.

Directorio de configuración personal

~/.qmc2 Es el directorio de configuración personal de QMC2 en nuestro home

Estadísticas de Compilación e Instalación de QMC2

Estadísticas de Compilación e Instalación de QMC2
CPU AMD Ryzen 5 5500
MHz 3593.250 (BoostMax=4457.000)
RAM 32 GB
Tarjeta gráfica AMD Radeon RX 580 2048SP
Controlador de gráficos AMDGPU 23.0.0
Sistema de archivos XFS
Versión del Kernel 6.5.8-ml SMP PREEMPT_DYNAMIC x86_64
Modo de frecuencia de la CPU powersave (balance performance)
Planificador de CPU BORE+EEVDF
Versión de Glibc 2.38
Enlazador dinámico Mold 2.3.1
Compilador GCC 13.2.0 + Ccache 4.8.3
Parámetros de optimización -03 -march=znver3 -mtune=znver3 -ftree-loop-linear -floop-strip-mine -floop-block'
Parámetros de Ccache adicionales CCACHE_NOCPP2=true
Parámetros de compilación -j12
Tiempo de compilación 1' 09"
Archivos instalados 810
Mostrar/Ocultar la lista de archivos instalados
Enlaces simbólicos creados 1.488
Mostrar/Ocultar la lista de enlaces simbólicos creados
Ocupación de espacio en disco 20,1 MB

Consumo inicial de CPU y RAM de QMC2

Consumo inicial de CPU y RAM de QMC2
Programa
CPU RAM
qmc2-sdlmame 0 % 845,2 MB

Desinstalación como root

1) MODO TRADICIONAL

Este programa no tiene soporte para desinstalación con el comando 'make uninstall'

2) MODO MANUALINUX

qmc2-0.243-scripts.tar.gz

$ su
# tar zxvf qmc2-0.243-scripts.tar.gz
# cd qmc2-0.243-scripts
# ./Desinstalar_qmc2-0.243

Copia de Seguridad como root

$ su
# tar zxvf qmc2-0.243-scripts.tar.gz
# cd qmc2-0.243-scripts
# ./Respaldar_qmc2-0.243

Restaurar la Copia de Seguridad como root

$ su
# cd /var/copibin/restaurar_copias
# ./Restaurar_qmc2-0.243



Iniciamos QMC2  

Sólo nos queda teclear en una terminal o en un lanzador el comando qmc2, y el programa aparecerá en la pantalla. No es compatible con Nouveau.


Captura QMC2 - 1


Captura QMC2 - 2


Captura QMC2 - 2




Funciones principales del teclado  

5 Inserta moneda
1 Inicia la partida
Flechas direccionales Movimiento del personaje
CTRL  Botón 1
ALT Botón 2
Espacio Botón 3
P Pausa el juego
Escape Termina MAME
F2 Modo servicio
Tabulador Despliega el menú de opciones de MAME

Estas opciones son efectivas cuando está corriendo MAME y pueden variar en función del juego en curso.



Enlaces    


https://mamedev.org >> La web de MAME.

https://github.com/qmc2/qmc2-mame-fe >> Enlace al proyecto en GitHub de QMC2.


Foro Galería Blog


Actualizado el 26-03-2024

Emuladores - MAME

Emuladores - Gens/GSEmuladores - ScummVM