MAMEWAH: Documentación, archivos .ini

Este es el modo en el que funciona el sistema de archivos .ini: MAMEWAH usa tres tipos principales de ficheros .ini de configuración; mamewah.ini (configuración general/principal), NOMBRE_EMULADOR.ini (configuración específica para un emulador), y NOMBRE_EMULADOR-?.ini (configuración específica para una lista, donde ? es el número de lista).

mamewah.ini se autogenera/regenera cuando ejecute MAMEWAH, y reside en \mamewah (la carpeta raiz del 'front-end').

Para generar un archivo NOMBRE_EMULADOR.ini o NOMBRE_EMULADOR-?.ini, simplemente cree un archivo de texto vacío con el nombre correcto en la carpeta \mamewah\ini (p.e. mame.ini, mame-0.ini, mame-1.ini, etc...), y ejecute MAMEWAH. Entonces, el archivo .ini será rellenado automáticamente con los valores por defecto. Necesitará un archivo NOMBRE_EMULADOR.ini para cada emulador que desee incorporar a MAMEWAH, y el número de listas disponible para cada uno de ellos estará determinado por cuántos archivos NOMBRE_EMULADOR-?.ini tenga (NOMBRE_EMULADOR-0.ini será siempre la lista principal, NO filtrable).

Visión general de las opciones

mamewah.ini

• ### mamewah.ini ###

• ### (Global) Screen-Saver Options ### (Opciones del protector de pantalla)
• delay                               5 (Tiempo en segundos que tarda en activarse el protector de pantalla)
• slide_duration                      3 (Tiempo en segundos que se muestra cada imagen)

• ### Audio Options ###        (Opciones de sonido)
• enable_sounds               1 (0=no, 1=sí)
• sound_volume              100 (Volumen de los sonidos 0-100%)
• music_path                    (Carpeta de la música, p.e. c:\musica)
• enable_music                1 (0=no,1= sí)
• music_volume              100 (Volumen de la música 0-100%)

• ### Movie Options ###                   (Opciones de los vídeos)
• intro_movie_file                        (Vídeo de arranque de MAMEWAH, p.e. c:\videos\intro.mpg)
• exit_movie_file                         (Vídeo de salida de MAMEWAH, p.e. c:\videos\exit.mpg)
• keep_movie_preview_aspect   game_aspect (Mantener proporciones de los vídeos de los juegos: no / video_aspect = mostrar el vídeo con sus proporciones reales / game_aspect = mostrar el vídeo con las proporciones de la imagen del juego)
• delay_before_movie_preview            2 (Tiempo en segundos antes de que se muestren los vídeos de los juegos)
• music_movie_mix             mute_movies (Mezclado del sonido de los juegos: mute_movies = no escuchar sonido de los vídeos de los juegos / merge = escuchar música de fondo y sonido de los vídeos / pause_music = pausar la música de fondo)
• movie_volume                        100 (Volumen de los vídeos de los juegos 0-100%)

• ### Misc Options ###               (Opciones varias)
• layout             Classic 640x480 (Carpeta de 'layouts' a usar, mire la documentación de layouts)
• ctrlr                              (Archivo ctrlr a usar, mire la documentación sobre controles)
• wrap_list                        0 (Al llegar al final de la lista, volver a empezar: 0=no, 1=sí)
• remember_current_game            1 (Recordar juego actual: 0=no, 1=sí)
• keep_image_aspect                1 (Mantener proporciones de imágenes: 0=no, 1=sí)
• refresh_images                   0 (Refrescar imágenes 0=no, 1=sí)
• correct_orientations    horizontal (Horientación correcta: horizontal / vertical / no)
• safe_mode                        0 (0=no, 1=sí)
• show_cursor                      0 (0=no, 1=sí)
• keyboard_led_states          -,-,- (Estado de los LEDs del teclado x,x,x donde x=: -=dejar como esté, 0=apagado, 1=encendido, p.e. 1,1,1)
• winipac_file                       (Ruta del archivo .exe de winipac, p.e. c:\winipac\winipac.exe)
• mamewah_ipc_file                   (Archivo ipc por defecto de ipac, p.e. c:\ipc\mamewah.ipc)
• lcd_com_port                     1 (Número de puerto serie [com] de la pantalla LCD)
• lcd_settings                       (Opciones del LCD *)
• exit_action                 choice (Acción al salir de MAMEWAH: choice = preguntar, windows = salir directos a windows, run_app = ejecutar aplicación, reboot = reiniciar, shutdown = apagar)
• app_to_run_on_exit                 (Aplicación que se ejecutaría al salir, p.e. c:\app.exe)

• ### Settings used by MAMEWAH ### (Opciones usadas por MAMEWAH)
• current_emulator            mame (Ignórelo, lo genera MAMEWAH)
• locked                         0 (Ignórelo, lo genera MAMEWAH)
• last_ipc                         (Ignórelo, lo genera MAMEWAH)

* Las opciones para el LCD deben ser de este modo:

• baud rate: (110, 300, 600, 1200, 2400, 9600, 14400, 19200, 28800, 38400, 56000, 128000, 256000)
• parity: ([e]ven, [o]dd, [n]one, [m]ark, [s]pace)
• data bits: (4-8)
• stop bits: (1, 1.5, 2)

Ejemplo: 9600,n,8,1

NOMBRE_EMULADOR.ini

• ### NOMBRE_EMULADOR.ini ###

• emulator_title (Título que desee para el emulador, p.e. M.A.M.E.)

• ### List Generation Settings ###               (Opciones de generación de lista de juegos)
• rom_path                                       (Carpeta de las 'ROMs', p.e. c:\mame\roms)
• rom_extension                              zip (file extension)
• dat_file                                       (Fichero '.dat', p.e. c:\mame\mame.dat)
• nms_file                                       (Fichero '.nms', p.e. c:\mame\mame.nms)
• catver_ini_file                                (Fichero 'catver.ini', p.e. c:\mame\catver.ini)
• list_generation_method   rom_folder_vs_listxml (Método de generación de la lista: rom_folder = 'ROMs' de la carpeta, rom_folder_subfolders = 'ROMs' de las subcarpetas, dat_file / rom_folder_vs_dat_file / rom_folder_vs_listinfo / verifysets_vs_listinfo / rom_folder_vs_listxml / verifysets_vs_listxml)

• ### Execution Settings ###    (Opciones de ejecución)
• emulator_executable           (Archivo ejecutable del emulador, p.e. c:\mame\mame.exe)
• commandline_format            (Línea de comandos del emulador *)
• alt_commandline_format_1      (Línea de comandos alternativa 1 del emulador *)
• alt_commandline_format_2      (Línea de comandos alternativa 2 del emulador *)
• game_specific_config_path     (Carpeta con configuraciones específicas '.cfg' para los juegos, p.e. c:\gameconfig)

• ### Artwork Locations ###
• artwork_1_image_path      (Carpeta de imágenes 1, p.e. c:\mame\snap)
• artwork_2_image_path      (Carpeta de imágenes 2, p.e. c:\mame\snap)
• artwork_3_image_path      (Carpeta de imágenes 3, p.e. c:\mame\snap)
• artwork_4_image_path      (Carpeta de imágenes 4, p.e. c:\mame\snap)
• artwork_5_image_path      (Carpeta de imágenes 5, p.e. c:\mame\snap)
• artwork_6_image_path      (Carpeta de imágenes 6, p.e. c:\mame\snap)
• artwork_7_image_path      (Carpeta de imágenes 7, p.e. c:\mame\snap)
• artwork_8_image_path      (Carpeta de imágenes 8, p.e. c:\mame\snap)
• artwork_9_image_path      (Carpeta de imágenes 9, p.e. c:\mame\snap)
• artwork_10_image_path     (Carpeta de imágenes 10, p.e. c:\mame\snap)
• movie_preview_path        (Carpeta con vídeos de los juegos, p.e. c:\mame\previews)
• movie_artwork_no        1 (Número del arte donde se mostrarán los vídeos: 1-10)

• ### Screen-Saver Settings ###      (Opciones de salvapantallas)
• enable_music_in_screensaver      1 (Escuchar música durante el salvapantallas: 0 = no, 1 = sí)
• saver_type               slideshow (Tipo de salvapantallas: blank_screen = pantalla en negro, slideshow = galería de fotos de los juegos, movie = reproducir vídeos, run_selected_game = ejecutar el juego seleccionado, run_random_game = ejecutar un juego aleatorio, run_random_game_and_quit = ejecutar un juego aleatorio y salir, run_random_game_using_wrapper = ejecutar un juego aleatorio a traves de un 'wrapper', launch_scr = ejecutar un salvapantallas de winwows, power_saving = activar modo de ahorro de energía, shutdown = apagar ordenador)
• movie_path                         (Carpeta de vídeos, p.e. c:\movies, sólo para el modo 'movie')
• quit_delay                         (Tiempo para salir en segundos, sólo para el modo 'run_random_game_and_quit')
• wrapper_executable                 (Nombre de archivo del 'wrapper', p.e. c:\mame\cmd-launch2.exe, sólo para el modo 'run_random_game_using_wrapper')
• wrapper_commandline_format         (Formato de línea de comandos para el 'wrapper', sólo para el modo 'run_random_game_using_wrapper' *)
• scr_file                           (Archivo de salvapantallas, p.e. c:\mamess\mamescreensaver.scr, sólo para el modo 'launch_scr')

• ### External Application Settings ### (Opciones para aplicaciones externas)
• ipc_file_or_path                      (Ruta o nombre del archivo .ipc, p.e. c:\ipc\mame.ipc o c:\ipc)
• app_1_executable                      (Nombre de archivo ejecutable de la aplicación externa #1, p.e. c:\cpviewer\cpviewer.exe)
• app_1_commandline_format              (Commandline de la aplicación externa #1 *)
• app_2_executable                      (Nombre de archivo ejecutable de la aplicación externa #2, p.e. c:\cpviewer\cpvgeneric.exe)
• app_2_commandline_format              (Commandline de la aplicación externa #2 *)
• app_3_executable                      (Nombre de archivo ejecutable de la aplicación externa #3, p.e. c:\jukebox\jukebox.exe)
• app_3_commandline_format              (Commandline de la aplicación externa #3 *)
• auto_launch_apps                      (Orden en el que las aplicaciones son ejecutadas antes del emulador, p.e. 1,2,3 o 3,2,1 o 1,2 o 1 etc. Sólo usaremos esta opción si deseamos que se ejecuten automáticamente las aplicaciones)

• ### Additional Settings ### (Opciones adicionales)
• music_path                  (Carpeta de música, p.e. c:\music)
• lcd_display_file_path       (Carpeta de ficheros del LCD, p.e. c:\lcd)
• lcd_fe_text                 (Texto mostrado por el LCD mientras esté en el Front-end, p.e. M.A.M.E. - Multiple Arcade Machine Emulator)

• ### Settings used by MAMEWAH ### (Opciones usadas por MAMEWAH)
• current_list                   0 (Ignórelo, generado por MAMEWAH)

* etiquetas para las líneas commandline_format:

Además de los 'interruptores' normales, también podremos usar las siguientes expresiones, MAMEWAH las reemplazará con la información correspondiente del juego que tenga seleccionado en el momento de lanzar la aplicación:

• [description] : Nombre completo del juego.
• [name] : Nombre de la 'ROM' del juego.
• [year] : Año de producción.
• [manufacturer] : Fabricante.
• [cloneof] : Nombre del juego 'parent'.
• [romof] : Nombre de la 'ROM parent' del juego.
• [screen] : Tipo de pantalla.
• [orientation] : Orientación de la pantalla (horizontal o vertical).
• [input] : Tipo de controles.
• [status] : Estado del 'driver'.
• [color] : Estado de los colores.
• [sound] : Estado del sonido.
• [category] : Categoría o género del juego.

Tenga en cuenta que si -clone [cloneof] está presente en la línea commandline_format, y el juego seleccionado no es un clon, entonces -clone [cloneof] será ignorado.

Con el objetivo de modificar el formato de la línea de comandos, pueden ser usadas las siguientes etiquetas:

• [rompath] : Ruta de la 'ROM' excluyendo la barra final '\'.
• [romext] : Extensión de la 'ROM' excluyendo el punto '.'.
• {8.3cadena} : Puede ser usada para convertir 'cadena' a un nombre corto de fichero (8.3) (tenga en cuenta que las comillas, si se da el caso, deben ser usadas por fuera de los signos '{}').
• {dosbox} : La ventana de consola de windows es visible por encima del emulador o aplicación lanzada.
• {nodosbox} : La ventana de consola de windows se oculta.
• {autodosbox} : La ventana de consola será visible sólo si es necesaria tras lanzar el emulador o aplicación (¡¡esta opción debería ser usada únicamente con M.A.M.E.!!).
• {safelaunch} : El emulador/aplicación será ejecutado en modo seguro. Use esta opción si los emuladores/aplicaciones no se ejecutan correctamente desde MAMEWAH.
• {nosafelaunch} : Indica que se lance el emulador/aplicación del modo normal (use esta opción siempre que sea posible).
• {nomusic} : Pausará la música de fondo de MAMEWAH mientras se esté ejecutando la aplicación/emulador.
• {music} : Permite que la música de fondo de MAMEWAH se siga reproduciendo mientras estemos en el emulador/aplicación.
• {nocursor} : Oculta el cursor mientras el emulador/aplicación está funcionando.
• {cursor} : Hace que el cursor sea visible mientras estemos ejecutando el emulador/aplicación.
• {cursor nombrefichero} : Hará visible el cursor indicado por 'nombrefichero' mientras esté funcionando el emulador/aplicación.

Notas:

• Si no especifica ninguna etiqueta 'dosbox', se supondrá {dosbox}.
• Si no especifica ninguna etiqueta 'safelaunch', se supondrá {safelaunch}.
• Si no especifica ninguna etiqueta 'music', se supondrá {nomusic}.
• Si no especifica ninguna etiqueta 'cursor', se supondrá {nocursor}.
• Las etiquetas rodeadas por corchetes '{}' no son enviadas por línea de comandos al emulador, sólo son interpretadas por MAMEWAH.

NOMBRE_EMULADOR-1.ini

• ### emuname-1.ini ###

• list_title                  (Título de la lista, el que usted desee, p.e. 'Juegos de peleas')

• ### Games List Settings ### (Opciones de la lista de juegos)
• cycle_list                1 (Permitir cambiar de lista, 0 = no, 1 = sí)
• list_type            normal (Tipo de lista: normal, most_played = jugados más veces, longest_played = jugados más tiempo)
• display_clone_info        0 (Mostrar información de clones: 0 = no, 1 = sí)
• max_favorites             0 (Número máximo de favoritos: 0 = sin límite, >0 = límite)

• ### Execution Settings ###   (Opciones de ejecución)
• commandline_format           ('Commandline' del emulador *)
• alt_commandline_format_1     ('Commandline' alternativo 1 del emulador *)
• alt_commandline_format_2     ('Commandline' alternativo 2 del emulador *)

• ### Settings used by MAMEWAH ### (Opciones usadas por MAMEWAH)
• current_game                   1 (Juego actual, ignórelo, lo genera MAMEWAH)

NOTA: NOMBRE_EMULADOR-0.ini NO tiene las opciones list_type, display_clone_info ni max_favorites ya que dichas propiedades están prefijadas para las listas principales.

Minwah