Difference between revisions of "Mamewah Ini"
Spacefractal (talk | contribs) m (added "back to mamewah frontpage" link) |
(added screen-saver settings to (emuname).ini) |
||
| Line 321: | Line 321: | ||
|} | |} | ||
| + | ===Screen-Saver Settings=== | ||
| + | {| Width="100%" valign="top" border="1" cellspacing="0" cellpadding="3" style="background:white; color:black; border:1px solid silver;" | ||
| + | |- style="background:navy; color:white" | ||
| + | |'''Setting''' | ||
| + | |'''default''' | ||
| + | |'''description''' | ||
| + | |- | ||
| + | |enable_music_in_screensaver | ||
| + | |1 | ||
| + | |1=yes,0=no, if music should be enabled when the screensaver is active | ||
| + | |||
| + | |- | ||
| + | |saver_type | ||
| + | |slideshow | ||
| + | |(blank_screen / slideshow / movie / run_selected_game / run_random_game / run_random_game_and_quit / run_random_game_using_wrapper / launch_scr / power_saving / shutdown) type of screen saver to use | ||
| + | |||
| + | |- | ||
| + | |movie_path | ||
| + | |(empty) | ||
| + | |(movie folder, eg c:\movies - saver_type movie only) | ||
| + | |||
| + | |- | ||
| + | |quit_delay | ||
| + | |(empty) | ||
| + | |in seconds, (saver_type run_random_game_and_quit only ) | ||
| + | |||
| + | |- | ||
| + | |wrapper_executable | ||
| + | |(empty) | ||
| + | |wrapper filename, eg c:\mame\cmd-launch2.exe - run_random_game_using_wrapper only | ||
| + | |||
| + | |- | ||
| + | |wrapper_commandline_format | ||
| + | |(empty) | ||
| + | |emulator commandline format - (run_random_game_using_wrapper only) | ||
| + | |||
| + | |- | ||
| + | |scr_file | ||
| + | |(empty) | ||
| + | |screensaver filename, eg c:\mamess\mamescreensaver.scr - (launch_scr only) | ||
| + | |||
| + | |} | ||
==emuname-?.ini== | ==emuname-?.ini== | ||
Revision as of 14:29, 13 May 2006
Ini files are commonly used for configuring program options. These files end in the extension .ini and are standard text files which can be opened in any text editing application, such as notepad.
MAMEWAH uses three main types of ini config files; mamewah.ini (main/global settings), emuname.ini (emulator-specific settings), and emuname-?.ini (list-specific settings, where ? is the list no.).
mamewah.ini is auto-generated/updated when you run MAMEWAH, and resides in \mamewah.
To generate emuname.ini or emuname-?.ini, simply place suitably named text file(s) in the \mamewah\ini folder (eg mame.ini, mame-0.ini, mame-1.ini etc.), and run MAMEWAH. The ini files will be automatically populated/updated with default settings. You must have emuname.ini for each emulator you require, and the number of lists available is determined by however many emuname-?.ini files you have (emuname-0.ini will be the main, non-filterable list).
Contents
mamewah.ini
The mamewah.ini file is the global configuration file, allowing you to configure the general options for mamewah, such as audio, video, or screensaver options.
(Global) Screen Saver Options
| Setting | default | description |
| delay | 5 | in seconds, the delay before the screen saver begins |
| slide_duration | 3 | in seconds, the time to wait in between slides |
Audio Options
| Setting | default | description |
| enable_sounds | 1 | 1=yes/0=no, whether sounds are enabled |
| sound_volume | 100 | 0-100, % of the sound volume |
| music_path | (empty) | full path to folder containing music (mp3's) to play |
| enable_music | 1 | 1=yes/0=no, whether music is enabled |
| music_volume | 100 | 0-100, % of the music volume |
Movie Options
| Setting | default | description |
| intro_movie_file | (empty) | full path to a movie file (mpg/avi) that plays at startup |
| exit_movie_file | (empty) | full path to a movie file (mpg/avi) that plays at exit |
| keep_movie_preview_aspect | game_aspect | (no/video_aspect/game_aspect) |
| delay_before_movie_preview | 2 | in seconds, the delay before a movie preview is shown |
| music_movie_mix | mute_movies | (mute_movies/merge/pause_music) when playing movies and music, should it mute the movie sound and only play the music, play the movie sound with the music, or pause the music and only play the movie sound |
| movie_volume | 100 | 0-100, % of the movie volume |
Misc Options
| Setting | default | description |
| layout | Classic 640x480 | the name of the layout/skin to use |
| ctrlr | (empty) | name of the ctrlr file to use |
| wrap_list | 0 | 1=yes/0=no, |
| remember_current_game | 1 | 1=yes/0=no, should MAMEWAH start on the last game selected |
| keep_image_aspect | 1 | 1=yes/0=no, should MAMEWAH keep the image aspect ratio |
| refresh_images | 0 | 1=yes/0=no, should MAMEWAH refresh images as you are scrolling (1) or once you have finished scrolling (0) |
| correct_orientations | horizontal | (horizontal/vertical/no) |
| safe_mode | 0 | 1=yes/0=no |
| show_cursor | 0 | 1=yes/0=no, show/hide the windows cursor |
| keyboard_led_states | (-,-,-) | (x,x,x where x=: -=leave, 0=off, 1=on, eg 1,1,1) |
| winipac_file | (empty) | full path of the winipac.exe file |
| mamewah_ipc_file | (empty) | default ipac ipc file |
| lcd_com_port | 1 | 1-4, com port that an LCD is hooked up to |
| lcd_settings | (empty) | 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)
|
| exit_action | choice | (choice / windows / run_app / reboot / shutdown) |
| app_to_run_on_exit | (empty) | full path of application to run on exit of MAMEWAH |
Settings used by MAMEWAH
DO NOT CHANGE, THIS IS GENERATED AUTOMATICALLY BY MAMEWAH
| Setting | Default | Description |
| current_emulator | mame | the last emulator that was used |
| locked | 0 | whether or not the menu is locked |
| last_ipc | (empty) | last ipc file used |
(emuname).ini
The emulator specific ini files are the settings which tell Mamewah how to run or launch a particular emulator. There should be one of these for each emulator you wish to run from Mamewah.
List Generation Settings
| Setting | default | description |
| rom_path | (empty) | the full path of the location to your rom files |
| rom_extension | zip | the file extension(s) that your roms use |
| dat_file | (empty) | the full file path to a dat file with rom information |
| nms_file | (empty) | the full file path to an nms file with rom information |
| catver_ini_file | (empty) | the full file path to a catver.ini file |
| list_generation_method | rom_folder_vs_listxml | (rom_folder / rom_folder_subfolders / dat_file / rom_folder_vs_dat_file / rom_folder_vs_listinfo / verifysets_vs_listinfo / rom_folder_vs_listxml / verifysets_vs_listxml), how Mamewah generates its game list |
Execution Settings
| Setting | default | description |
| emulator_executable | (empty) | the full path to the executable for the emulator |
| commandline_format | (empty) | any command line parameters that need to be passed to the emulator when executed |
| alt_commandline_format_1 | (empty) | an alternate set of commandline options to pass |
| alt_commandline_format_2 | (empty) | a 2nd set of alternate commandline options to pass |
| game_specific_config_path | (empty) | certain emulators require a specific path to the config files, which can be included here |
Artwork Locations
| Setting | default | description |
| artwork_#_image_path | (empty) | 1-10, ten seperate paths for image locations (i.e. screens, titles, boxart, etc) |
| movie_preview_path | (empty) | full path to a movie preview |
| movie_artwork_no | 1 | which artwork_#_image_path contains movies instead of images |
Screen-Saver Settings
| Setting | default | description |
| enable_music_in_screensaver | 1 | 1=yes,0=no, if music should be enabled when the screensaver is active |
| saver_type | slideshow | (blank_screen / slideshow / movie / run_selected_game / run_random_game / run_random_game_and_quit / run_random_game_using_wrapper / launch_scr / power_saving / shutdown) type of screen saver to use |
| movie_path | (empty) | (movie folder, eg c:\movies - saver_type movie only) |
| quit_delay | (empty) | in seconds, (saver_type run_random_game_and_quit only ) |
| wrapper_executable | (empty) | wrapper filename, eg c:\mame\cmd-launch2.exe - run_random_game_using_wrapper only |
| wrapper_commandline_format | (empty) | emulator commandline format - (run_random_game_using_wrapper only) |
| scr_file | (empty) | screensaver filename, eg c:\mamess\mamescreensaver.scr - (launch_scr only) |
emuname-?.ini
The emulator list specific ini files are the settings which tell Mamewah how to handle each list that is created for a particular emulator. While it is not required to configure these, it allows you to create custom lists, such as favorites, or "best of", without losing the Main/Full list option. There should be a (emuname)-0.ini which handles settings for the main list, and then a (emuname)-#.ini for each additional list configured for that emulator.
