AdvMenu: Documentación

1 Sinopsis

advmenu [-default] [-remove] [-cfg FICHERO] [-log] [-version] [-help]

2 Descripción

AdvanceMENU es un front-end (entorno gráfico) que ejecuta AdvanceMAME, AdvanceMESS, MAME, MESS, xmame, Raine y otros emuladores.

Simplemente ejecútalo en el mismo directorio del emulador y pulsa 'F1' para obtener ayuda o 'º' para el menú principal.

Pulsa 'TAB' para cambiar el modo de presentación. Pulsa 'ESPACIO' para cambiar el modo de previsualización.

Para ejecutar un juego pulsa 'ENTER'. Pulsa 'ESC' para salir.

Las características principales son:

  • Simplemente descárgalo y ejecútalo. ¡ Copia el ejecutable y lánzalo !
  • Actualización automática de la información de cada rom.
  • Orientación vertical y horizonal.
  • Soporte para cualquier TV/Monitor Arcade al igual que AdvanceMAME pero también va perfecto para monitores PC normales.
  • Previsualización con imagen y vídeo estático y animado (PNG/PCX/ICO/MNG). ¡ Hasta 192 imágenes simultáneamente !
  • Previsualización de sonido (MP3/WAV). Puedes seleccionar un sonido especial para cada juego jugado cuando el cursor se mueve sobre él.
  • Sonido de fondo (MP3/WAV). Escuya tus canciones favoritas o grabaciones de radio de fondo.
  • Efectos sonoros (MP3/WAV) paraal pulsar una tecla, empezar el programa, empezar un juego, salir del programa...
  • Soporte para imágenes comprimidas y archivos sonoros.
  • Salvapantallas. Una presentación de las imágenes de los juegos.
  • Imagen de fondo seleccionable e imágenes de ayuda translúcidas.

Las secciones de este documento son:

3 Opciones

-default
Añade al fichero de configuración todas las opciones que faltan con valores por defecto.

-remove
Elimina del fichero de configuración todas las opciones que llevan valores por defecto.

-cfg FICHERO
Selecciona un fichero de configuración alternativo. En Linux y MAC OS X puedes prefijar el nombre del fichero con "./" para cargarlo del directorio actual.

-log
Crea el fichero 'advmenu.log' con mucha información interna. Muy útil para informe de errores.

-verbose
Muestra alguna información de arranque.

-version
Muestra el número de la versión, los drivers de bajo-nivel soportados y los directorios de configuración.

-help
Muestra una pequeña ayuda para la línea de comandos.

En Linux y Mac OS X puedes usar también '--' por delante de las opciones en lugar de '-'. En DOS y Windows puedes usar también '/¡de las opciones

4 Emuladores

El programa soporta muchos tipos de emuladores. Los emuladores AdvanceMAME, AdvanceMESS, MAME, xmame, DMAME, DMESS y DRAINE están directamente soportados y lo único que tendrías que hacer es ejecutar el programa AdvanceMENU en el mismo directorio del emulador.

El resto de emuladores está soportado bajo el tipo de emulador 'generic'.

4.1 generic - Emulador genérico

Para el emulador 'generic' no se requiere información adicional a la rom. Sólo se utilizan el nombre y el tamaño de los ficheros roms.

Debes especificar toda la información del emulador y directorios con las opciones 'emulator' y 'emulator_*' en el fichero 'advmenu.rc'.

Necesitas usar al menos las opciones 'emulator' y 'emulator_roms' para informar a AdvanceMENU cómo ejecutar el emulador y dónde encontrar las roms.

Por ejemplo:

emulator "snes9x" generic "c:\game\snes9x\snes9x.exe" "%f"

emulator_roms "snes9x" "c:\game\snes9x\roms"

emulator_roms_filter "snes9x" "*.smc;*.sfc;*.fig;*.1"

emulator "zsnes" generic "c:\game\zsnes\zsnes.exe" "-e -m roms\%f"

emulator_roms "zsnes" "c:\game\zsnes\roms"

emulator_roms_filter "zsnes" "*.smc;*.sfc;*.fig;*.1"

Las opciones %s, %f, %p, ... están explicadas en la descripción de la opción 'emulator'.

Las roms se buscan en la ruta especificada con la opción 'emulator_roms' en el fichero 'advmenu.rc'. Para cada fichero encontrado (con cualquier extensión) se añade un juego en el menú. Puedes filtrar los ficheros con la opción 'emulator_roms_filter'.

Las fotos de los juegos se buscan en los directorios especificados con las opciones 'emulator_*' usando el mismo nombre del fichero de la rom.

Si quieres, puedes escibir manualmente un fichero de información como el deMAME y nombrarlo 'NOMBRE DEL EMULADOR.lst'. Este fichero tiene el mismo formato de salida que el '-listinfo' del comando MAME. De echo sólo se usa la información 'game', 'name', 'description', 'year', 'manufacturer' y 'cloneof', es decir, el nombre de la rom, el nombre del juego, la descripción, el año, el fabricante y de quién es clon, respectivamente. Observa que este fichero se utiliza sólo para añadir información a los juegos existentes. Los juegos presentes en este fichero no son automáticamente añadidos a la lista de juegos.

4.2 advmame - AdvanceMAME

Para el tipo de emulador 'advmame' la información de las roms se obtiene del fichero 'NOMBRE DEL EMULADOR.xml'. Si este fichero no existe, se crea automáticamente con el comando '-listxml' del emulador.

Los directorios especificados en la opción 'dir_rom' del fichero 'advmame.rc' son utilizados para detectar la lista de las roms disponibles. En las versiones DOS y Windows del programa se busca el fichero 'advmenu.rc' en el mismo directorio del emulador. En la versión para Unix se busca en el directorio 'HOME/.advance'.

El directorio especificado en 'dir_snap' es utilizado para detectar la lista de pantallazos disponibles.

4.3 advmess - AdvanceMESS

Para el emulador 'advmess' la información de las roms se obtiene del fichero 'NOMBRE DEL EMULADOR.xml'. Si este fichero no existe, se crea automáticamente con el comando '-listxml' del emulador.

Los directorios especificados en la opción 'dir_rom' del fichero 'advmess.rc' se utilizan para detectar la lista de bios disponibles.

Se leen los directorios listados en la opción 'dir_image' y todos los ficheros encontrados en los directorios de cada 'máquina' se insertan como software si la extensión es reconocida como dispositivo válido para la 'máquina' actual o si es un fichero 'zip'. Por ejemplo si la opción 'dir_image' contiene 'c:\software', AdvanceMENU escanea los directorios 'c:\software\ti99_4a', 'c:\software\sms', 'c:\software\gameboy', ... Los ficheros en el directorio raíz 'c:\software' NO son chequeados.

Cuando seleccionas ejecutar un fichero zip, dicho fichero se abre y todos los ficheros contenidos en él con nombre válido y con una extensión de dispositivo reconocida se añaden a la línea de comandos de AdvanceMESS. Se considera que un fichero tiene un nombre válido si tiene el mismo nombre que el del zip con un carácter adicional. Por ejemplo en el fichero 'alpiner.zip' los ficheros 'alpiner.bin', 'alpinerc.bin' y 'alpinerg.bin' tienen nombres válidos. Esta característica se puede usar para agrupar todas las roms requeridas para ejecutar un programa en un solo fichero zip.

La extensión del fichero se utiliza también para seleccionar correctamente el tipo de dispositivo cuando se llama a AdvanceMESS.

El directorio especificado en 'dir_snap' se utiliza para detectar la lista de pantallazos disponibles. Al salir de AdvanceMESS si se crea un nuevo pantallazo, el fichero se mueve al directorio 'snap/sistema' correcto renombrándolo como el software ejecutado. Por ejemplo, supongamos que ejecutas el sistema 'ti99_4a' con el software 'alpiner'. Si pulsas F12 durante la emulación, se crea el fichero 'snap\ti99_4a.png'. Cuando vuelves a AdvanceMENU el fichero es movido automáticamente a 'snap/ti99_4a/alpiner.png'.

4.4 mame - MAME para Windows

Para el emulador 'mame' la información de las roms se obtiene del fichero 'NOMBRE DEL EMULADOR.xml'. Si este fichero no existe, se crea automáticamente con el comando del emulador '-listxml'.

Los directorios especificados en la opción 'rompath' en el fichero 'mame.ini' son utilizados para detectar la lista de roms disponibles.

El directorio especificado en 'snap_directory' es utilizado para detectar la lista de pantallazos disponibles.

4.5 xmame - xmame

Para el emulador 'xmame' la información de las roms se obtiene del fichero 'NOMBRE DEL EMULADOR.xml'. Si este fichero no existe, se crea automáticamente con el comando del emulador '-listxml'.

Los directorios especificados en la opción 'rompath' del fichero 'HOME/.xmame/mamerc' se utilizan para detectar la lista de roms disponibles.

El directorio especificado en 'screenshotdir' se utiliza para detectar la lista de ficheros de pantallazos disponibles.

4.6 dmame - MAME para DOS MAME

Para el emulador 'dmame' la información de las roms se obtiene del fichero 'NOMBRE DEL EMULADOR.xml'. Si este fichero no exist, se crea automáticamente con el comando del emulador '-listxml'.

Los directorios especificados en la opción 'rompath' en el fichero 'mame.cfg' se utilizan para detecta la lista de romsdisponibles.

El directorio especificado en 'snap' se utiliza para detectar la lista de pantallazos disponibles.

4.7 dmess - MESS para DOS

Para el emulador 'dmess' la información de las roms se obtiene del fichero 'NOMBRE DEL EMULADOR.xml'. Si este fichero no existe, se crea automáticamente con el comando del emulador '-listxml'.

Los directorios especificados en la opción 'biospath' del fichero 'mess.cfg' se utilizan para detectar la lista de bios disponibles.

Todos los directorios listados en la opción 'softwarepath' son leídos y todos los ficheros 'zip' encontrados en los directorios 'subsistema' son insertados como software. Por ejemplo si la opción 'softwarepath' contiene 'c:\software', AdvanceMENU escane todos los directorios 'c:\software\ti99_4a', 'c:\software\gameboy', ... Los ficheros zips del directorio raíz 'c:\software' NO son chequeados.

Cuando seleccionas una de estas entradas se abre el fichero zip y se busca el primer fichero con el mismo nombre del fichero zip pero con diferente extensión. Este fichero se utiliza como argumento de la opción '-cart' cuando se ejecuta 'mess'. AdvanceMENU NO puede usar otros soportes como '-flop'.

Todos los alias presentes en el 'mess.cfg' se insertan como entradas software. Cuando seleccionas una de estas entradas se usa la opción '-alias' de 'mess' para ejecutar el juego.

Puedes asignar una descripción arbitraria o una especificación de alias añadiéndolo en la misma línea del alias tras el carácter comentario '#' usando este formato:

ALIAS = ALIAS_DEF # Descripción | AÑO | FABRICANTE

Por ejemplo:

[ti99_4a]

ti-inva = -cart ti-invac.bin -cart ti-invag.bin \

    # Invaders | 1982 | Texas Instrument

Al salir del emulador si se ha creado un nuevo pantallazo, este fichero es movido al directorio correcto 'snap\sistema' renombrándolo como el software ejecutado. Por ejemplo, supongamos que ejecutas el sistema 'ti99_4a' con el software 'alpiner'. Si pulsas F12 durante la emulación, se crea el fichero 'snap\ti99_4a.png'. Cuando vuelves a AdvanceMENU el fichero es movido automáticamente a 'snap\ti99_4a\alpiner.png'.

4.8 draine - Raine para DOS

Para el emulador 'draine' la información de las roms se obtiene del fichero 'NOMBRE DEL EMULADOR.lst'. Si este fichero no existe, se crea automáticamente con el comando del emulador '-gameinfo'.

Todos los directorios especificados en las opciones 'rom_dir_*' se utilizan para detectar la lista de roms disponibles.

El directorio especificado en 'screenshots' se utiliza para detectar la lista de pantallazos disponibles.

5 Configuración

El fichero 'advmenu.rc' se utiliza para grabar el estado actual del front-end. Es leído al comienzo y grabado al salir. Puedes prevenir la grabación automática al salir con la opción 'config'.

En DOS y Windows las opciones de configuración se leen del fichero 'advmenu.rc' del directorio actual.

En Linux y Mac OS X las opciones de configuración se leen de los ficheros 'advmame.rc' y 'advmess.rc' en los directorios $host, $data y $home. El directorio $host es '$SYSCONFDIR', donde $SYSCONFDIR es el directorio 'sysconfdir' configurado con es script 'configure'. El valor por defecto es '/usr/local/etc'. El directorio $data es '$DATADIR/advance', donde $DATADIR es el directorio 'datadir' configurado con el script 'configure'. El valor por defecto es '/usr/local/share'. El directorio $home es '$ADVANCE', donde $ADVANCE es el valor de la variable de entorno ADVANCE cuando se ejecuta el programa. Si falta la variable de entorno ADVANCE el directorio $home es '$HOME/.advance' donde $HOME es el valor de la variable de entorno HOME. Si faltan tanto la variable de entorno ADVANCE como HOME el directorio $data se convierte también en el directorio $home.

La prioridad de las opciones es en este orden: $host, $home y $data.

El directorio $home se utiliza también para que el programa escriba toda la información. Los ficheros en los directorios $host y $data son de sólo lectura.

Puede incluir ficheros de configuración adicional con la opción 'include'. En DOS y Windows los ficheros se buscan en el directorio actual. En Linux y Max OS X los ficheros se buscan en el directorio $home si son expresados como ruta relativa. Puedes forzar la búsqueda en el directorio actual prefijando el fichero con './'. Para incluir más de un fichero debes separar los nombres con ';' en DOS y Windows, y con ':' en Linux y Mac OS X.

Puedes forzar la creación de un fichero de configuración por defecto con la opción de la línea de comandos '-default'.

En DOS y Windows el separador de nombres de directorio es '\' y el separador multi-directorio es ';'. En Linux y Mac OS X el separador de nombres es '/' y el separador multi-directorio es ':'.

5.1 Opciones de Configuración Global

Esta sección describe las opciones globales utilizadas para adaptar el programa.

Se graba un subconjunto de opciones de configuración por emulador base para permitir diferentes configuraciones para diferentes emuladores. Observa que estas configuraciones específicas de emulador no se activan si eliges mostrar más de un emulador a la vez. En este caso sólo se utiliza la configuración por defecto. Concretamente estas opciones especiales son 'mode', 'sort', 'preview', 'group_include' y 'tipe_include'.

5.1.1 config

Selecciona si la configuración modificada por el usuario durante el manejo del programa se va a grabar o no, y en qué momento.

config save_at_exit | restore_at_exit | restore_at_idle

Opciones:

save_at_exit
Graba cualquier cambio antes de salir (opción por defecto).

restore_at_exit
No graba cambios. En la próxima ejecución, restaura la configuración previa.

restore_at_idle
Restaura la configuración previa tras el tiempo 'libre'

Puedes grabar manualmente la configuración durante la ejecución desde el menú principal.

5.1.2 emulator

Selecciona los emuladores a listar en el menú. Puedes especificar más de un emulador.

¡ATENCIÓN! Antes de probar esta opción, deberías hacer una copia de seguridad de tu fichero 'advmenu.rc' actual porque cuando eliminas un emulador, la información del juego para ese emulador (como p.ej. el tiempo jugado) se pierde.

emulator "EMULADOR" (generic | advmame | advmess | mame | dmame

    | dmess | draine) "[-]EJECUTABLE" "ARGUMENTOS"

Opciones:

EMULADOR
El nombre para el emulador. Debe ser diferente para cada emulador definido.

generic
Se trata de un emulador genérico.

advmame
Se trata del emulador AdvanceMAME.

advmess
Se trata del emulador AdvanceMESS.

mame
Se trata del emulador MAME de Windows.

dmame
Se trata del emulador MAME de DOS.

dmess
Se trata del emulador MESS de DOS.

draine
Se trata del emulador Raine de DOS.

[-]EJECUTABLE
La ruta al ejecutable del emulador. En DOS y Windows puedes también usar un batch (.bat), pero esto previene la generación automática del fichero listado que deberá generarse manualmente. Puedes poner un '-' en frente de la ruta para ignorar cualquier error retornado por el ejecutable.

ARGUMENTS
Los argumentos que se pasan al emulador. Los argumentos son requeridos sólo para el emulador 'generic'. Para el resto, AdvanceMENU añade automáticamente los argumentos requeridos para ejecutar un juego. Aun así, puedes seguir añadiendo argumentos extra.

En los argumentos del emulador algunas marcas se sustituyen por valores especiales:

%s
Sustituye al nombre de la rom sin extensión. P.ej. "pacman".

%p
Sustituye a la ruta completa de la rom. P.ej. "c:\emu\roms\pacman.zip"

%f
Sustituye al nombre de la rom con la extensión. P.ej. "pacman.zip".

%o[R0,R90,R180,R270]
Sustituye a una de las cadenas R*, dependiendo de la orientación actual del menú. Observa que no puedes usar espacio en la cadena R*. P.ej. "%o[,-ror,-flipx,-rol] %o[,,-flipy,]" rota correctamente el emulador AdvanceMAME.

Para el tipo de emulador 'generic' necesitas usar las marcas % para indicarle al emulador qué juego ejecutar. Para el resto de emuladores esta información la añade automáticamente AdvanceMENU.

Ejemplos para DOS y Windows:

emulator "AdvanceMAME" advmame "advmame\advmame.exe" \

"%o[,-ror,-flipx,-rol] %o[,,-flipy,]"

emulator "MAME" mame "mame\mame.exe" "-nohws"

emulator "MESS" dmess "mess\mess.exe" ""

emulator "Raine" draine "raine\raine.exe" ""

emulator "Raine adaptado" draine "raine\raine2.bat" ""

emulator "SNes9x" generic "c:\game\snes9x\snes9x.exe" "%f"

emulator "ZSNes" generic "c:\game\zsnes\zsnes.exe" "-e -m roms\%f"

Ejemplos para Linux y Mac OS X:

emulator "AdvanceMAME" advmame "advmame" \

"%o[,-ror,-flipx,-rol] %o[,,-flipy,]"

5.1.3 emulator_roms/roms_filter/altss/flyers/cabinets/icons/titles

Selecciona directorios adicionales para los emuladores. Estos directorios se usan como añadido a cualquier otro directorio en el fichero de configuración del emulador. Las imágenes de pantallazos y ficheros de sonidos se buscan también en cualquier fichero '.zip' presente en estos directorios.

emulator_roms "EMULADOR" "LISTA"

emulator_roms_filter "EMULADOR" "LISTA"

emulator_altss "EMULADOR" "LISTA"

emulator_flyers "EMULADOR" "LISTA"

emulator_cabinets "EMULADOR" "LISTA"

emulator_marquees "EMULADOR" "LISTA"

emulator_icons "EMULADOR" "LISTA"

emulator_titles "EMULADOR" "LISTA"

Comandos:

roms
Lista de directorios usados para las roms. Esta opción se usa sólo para el tipo de emulador 'generic'. El resto de emuladores usan el fichero de configuración específico para establecer la ruta de roms.

roms_filter
Lista de patrones para que un fichero sea listado. Un patrón vacío significa todos los ficheros.

altss
Directorio de pantallazos, usado para almacenar pantallazos y sonidos. Si es posible, también se usan los directorios especificados en el fichero de configuración del emulador.

flyers
Directorio para imágenes de flyers.

cabinets
Directorio para imágenes de muebles.

marquees
Directorio para imágenes de marquesinas.

icons
Directorio para iconos.

titles
Directorio para títulos.

Opciones:

EMULADOR
El nombre para el emulador. Debe ser el mismo que el que define al emulador.

LISTA
Lista de directorios o patrones. En DOS y Windows usa el carácter ';' como separador. En Linux y Mac OS X usa el carácter ':'.

Ejemplos para DOS y Windows:

emulator_roms "SNes9x" "c:\game\snes9x\roms;c:\game\zsnes\roms2"

emulator_roms_filter "SNes9x" "*.smc;*.sfc;*.fig;*.1"

emulator_flyers "SNes9x" "c:\game\zsnes\fly"

emulator_cabinets "SNes9x" "c:\game\zsnes\cab"

emulator_marquees "SNes9x" "c:\game\zsnes\mar"

emulator_roms "ZSNes" "c:\game\zsnes\roms"

emulator_roms_filter "ZSNes" "*.smc;*.sfc;*.fig;*.1"

5.1.4 mode

Selecciona el modo de listar los juegos.

[EMULADOR/]mode full | full_mixed | text | list | list_mixed | tile_small

    | tile_normal | tile_big | tile_enormous | tile_giant

    | tile_icon | tile_marquee

Opciones:

EMULADOR/
Nada para el emulador por defecto, o el nombre de un emulador para un emulador específico.

full
Pantallazos a pantalla completa.

full_mixed
Pantallazos a pantalla completa con 4 imágenes.

text
Lista de juegos.

list
Lista de juegos y pantallazo del juego seleccionado (valor por defecto).

list_mixed
Lista de juegos y 4 imágenes del juego seleccionado.

tile_small
Muestra los pantallazos de 4x3 juegos.

tile_normal
Muestra los pantallazos de 5x6 juegos.

tile_big
Muestra los pantallazos de 8x6 juegos.

tile_enormous
Muestra los pantallazos de 12x9 juegos.

tile_giant
Muestra los pantallazos de 16x12 juegos.

tile_icon
Modo especial para vista de iconos.

tile_marquee
Modo especial para vista de marquesinas.

5.1.5 sort

Selecciona el tipo de ordenación de los juegos mostrados.

[EMULADOR/]sort parent | name | time | play | year | manufacturer

    | type | group | size | resolution | info

Opciones:

EMULADOR/
Nada para el emulador por defecto, o el nombre de un emulador para un emulador específico.

parent
Nombre del juego original.

emulator
Nombre del emulador.

name
Nombre del juego.

time
Tiempo total jugado.

play
Número de veces jugado.

timeperplay
Tiempo por ejecución.

year
Año de creación del juego.

manufacturer
Fabricante del juego.

type
Tipo de juego.

group
Grupo en el que está incluido el juego.

size
Tamaño de la rom del juego.

resolution
Resolución gráfica del juego.

info
Información externa importada con la opción 'info_import'.

5.1.6 preview

Selecciona el tipo de imágenes mostradas.

[EMULADOR/]preview snap | titles | flyers | cabinets

Opciones:

EMULADOR/
Nada para el emulador por defecto, o el nombre de un emulador para un emulador específico.

snap
Ficheros en los directorios 'snap' y 'altss'.

flyers
Ficheros en los directorios 'flyers'.

cabinets
Ficheros en los directorios 'cabinets'.

titles
Ficheros en los directorios 'titles'.

Las imágenes 'icons' (iconos) y 'marquees' (marquesina) se pueden seleccionar con las opciones 'mode' especiales 'tile_icon' y 'tile_marquee'.

5.1.7 mode_skip

Deshabilita algunos modos de menú cuando pulsas 'tab'.

mode_skip (full | full_mixed | list | list_mixed | tile_small

    | tile_normal | tile_big | tile_enormous | tile_giant

    | tile_icon | tile_marquee)*

Opciones:

SKIP
Múltiples selecciones de modos deshabilitados. Utiliza una lista vacía para habilitar todos los modos.

Ejemplos:

mode_skip tile_giant

mode_skip full full_mixed list tile_small tile_giant

mode_skip

5.1.8 preview_expand

Alarga el área de pantalla usada para los juegos verticales en monitores horizontales (y juegos horizontales en monitores verticales).

preview_expand FACTOR

Opciones:

FACTOR
Factor de expansión desde 1.0 a 3.0 (por defeccto 1.5)

Ejemplos:

preview_expand 1.15

5.1.9 preview_default_*

Selecciona las imágenes por defecto. Cuando una imagen de un juego seleccionado no existe, se mostrará esta imagen por defecto.

preview_default "ARCHIVO"

preview_default_snap "ARCHIVO"

preview_default_flyer "ARCHIVO"

preview_default_cabinet "ARCHIVO"

preview_default_icon "ARCHIVO"

preview_default_marquee "ARCHIVO"

preview_default_title "ARCHIVO"

Comandos:

default
Selecciona la imagen por defecto para todos los modos de previsualización.

default_TAG
Selecciona la imagen por defecto para un modo de previsualización concreto.

Opciones:

ARCHIVO
La ruta completa de la imagen.

Ejemplos:

preview_default "C:\MAME\DEFAULT.PNG"

preview_default_marquee "C:\MAME\DEFMAR.PNG"

preview_default_icon "C:\MAME\DEFMAR.PNG"

5.1.10 icon_space

Selecciona el tamaño del espacio entre iconos. El modo 'icon' está disponible sólo si estableces la opción 'emulator_icons' en el fichero de configuración del emulador.

icon_space ESPACIO

Opciones:

ESPACIO
El número de píxels entre iconos (por defecto es 43).

En la vista de icono el título del juego se muestra en múltiples filas si no hay suficiente espacio para ello.

5.1.11 merge

Selecciona el formato esperado de tu conjunto de roms. Se utiliza para chequear la existencia de los ficheros correctos necesarios para ejecutar los juegos.

merge none | differential | parent | any | disable

Opciones:

none
Cada zip clon contiene todas las roms necesarias.

differential
Cada zip clon contiene sólo las roms específicas (por defecto).

parent
Todas las roms están en el zip origen.

any
Cualquiera de las anteriores, usa esta si tienes un conjunto de roms que están poco organizadas.

disable
Chequeo deshabilitado.

5.1.12 game

Contiene información variada de los juegos. Se añade una opción 'game' automáticamente en los ficheros de configuración para cualquier rom encontrada. Se utiliza para guardar cierta información del juego como el tiempo jugado.

game "EMULADOR/JUEGO" "GRUPO" "TIPO" TIEMPO VECES "DESC"

Opciones:

EMULADOR
Nombre del emulador.

JUEGO
Nombre corto del juego, generalmente el nombre de la rom sin extensión.

GRUPO
Nombre del grupo al que pertenece el juego, o vacío "".

TIPO
Nombre del tipo de juego, o vacío "".

TIEMPO
Tiempo jugado en segundos.

JUGADO
Número de veces ejecutado.

DESC
Descripción del usuario, o vacío "".

Los argumentos GRUPO, TIPO y DESC prevalecen sobre cualquier otro valor importado con las opciones 'group_import', 'type_import' y 'desc_import'. Los valores importados tienen efecto sólo si las opciones GRUPO, TIPO y DESC están vacías.

Ejemplos:

game "advmame/puckman" "Buenísimo" "Arcade" \

    1231 21 "Pac-Man Japonés"

game "advmame/1943" "" "" 121 4 "1943 !!"
[pre]


5.2 Opciones de Configuración de Vídeo

Esta sección describe las opciones usadas para ajustar la pantalla.

5.2.1 device_video_*

Estas opciones se utilizan para ajustar los drivers de vídeo. Se pueden utilizar todas las opciones 'device_video_*' definidas en el fichero 'advdev.txt'. Si usas un driver de vídeo 'System', no necesitas establecer estas opciones. Éstas son ignoradas en su mayoría. Con un driver de vídeo 'Generate' estas opciones son utilizadas para seleccionar y crear el modo de vídeo correcto. Si faltan, se utilizan los parámetros para un monitor estándar SVGA multisincronía.

5.2.2 display_size

Selecciona el ancho deseado del modo de vídeo. [pre] display_size ANCHO

Opciones:

ANCHO
Ancho en píxeles del modo de vídeo. Se establece el modo de vídeo más próximo disponible (por defecto es 1024).

5.2.3 display_restoreatgame

Selecciona si se debe restaurar el modo de vídeo antes de ejecutar el emulador.

[EMULADOR/]display_restoreatgame yes | no

Opciones:

EMULADOR/
Nada para el emulador por defecto, o el nombre de un emulador para un emulador específico.

yes
Restaura el modo de vídeo (por defecto).

no
Mantiene el modo gráfico actual.

5.2.4 display_restoreatexit

Selecciona si se debe restaurar el modo de vídeo antes de salir.

display_restoreatexit yes | no

Opciones:

yes
Restaura el modo de vídeo (por defecto).

no
Mantiene el modo gráfico actual.

5.2.5 display_orientation

Selecciona la orientación de la pantalla deseada.

display_orientation (flip_xy | mirror_x | mirror_y)*

Opciones:

mirror_x
Espejo en la dirección horizontal.

mirror_y
Espejo en la dirección vertical.

flip_xy
Intercambia los ejes x e y.

Ejemplos:

 
display_orientation flip_xy mirror_x

5.2.6 display_brightness

Selecciona el factor de brillo de la imagen.

display_brightness FACTOR

Opciones:

FACTOR
Factor de brillo sobre 1 (por defecto 1.0).

Ejemplos:

 
display_brightness 0.9

5.2.7 display_gamma

Selecciona el factor de corrección gamma de la imagen.

display_gamma FACTOR

Opciones:

FACTOR
Factor gamma sobre 1 (por defecto 1.0).

Ejemplos:

display_gamma 0.9
Marcianitos declina cualquier responsabilidad derivada del uso que se haga de la información de la web. Marcianitos no distribuye roms y no tiene ánimo de lucro.
Creative Commons License Esta obra está bajo una licencia de Creative Commons.