--mame emulator configuration file
--
--
--Paths starting with @ are considered to be relative paths to the frontend folder. The fe will replace the @ with the frontend path.
--End paths allways with \.
--
--
--1. Emulator related paths
--
emupath|@\emulators\mame\|#folder|Path that contains the executable.|
gamepath||#folder|Path to the items that have to be launched (for mame keep this empty and use the paths in mame.ini).|
workingdir|@\emulators\mame\|#folder|Set the working directory to this path. In most cases that will be the same as the emupath.|
shortnamepath||#folder|Some, mostly dos based, emulators can't lauch games with long file names. For those set this path to the location you keep the games. For all others keep this empty. The fe will search this path for the filename and then it will use the shortname to launch it. Keep this also to false when you don't have the complete filename with extension in the gamelist!|
--
--
--2. Artwork and information associated with emulator related paths
--
sshot|@\emulators\mame\snap\|#folder||
marquees|@\emulators\mame\marquees\|#folder||
flyers|@\emulators\mame\flyers\|#folder||
cabinets|@\emulators\mame\cabinets\|#folder||
titles|@\emulators\mame\titles\|#folder||
cpanels|@\emulators\mame\cpanels\|#folder||
additional_artwork_1||#folder||
additional_artwork_2||#folder||
additional_artwork_3||#folder||
additional_artwork_4||#folder||
genericmodelsart|@\emulators\emuname\genericmodelsart\|#folder||
glvideodir|@\emulators\Mame\videos\|#folder|Path for video's unzipped to be displayed on the 3d models|
qtvr|@\emulators\mame\qtvr\|#folder|Use any format supported by quicktime, like mov, mpg, mpeg2, mp4 etc. to be displayed in the information-, intro- and exit screens. By adapting a skin this can also be used to play movies fullscreen without launching an external player.|
gameinfo|@\emulators\mame\info\|#folder|Path for text and html files to be shown in the information menu.|
helppath|@\emulators\mame\help\|#folder|Path for bitmaps like controlpanel layouts. The frontend will search for them and when nothing is found show the general layout bitmap setup in the cfg file for the current skin.|
--
--
--3. Emulator specific options
--
mame|mame32.exe/Mame32p.exe|#selectexe|The executable to launch and an alternative executable that can be used with the altmame option.|
emuoption||#editable|Some executables need an additional parameter between the exe and the item to be launched. If that is the case you can use this option. For example '-play -' for visual pinball or 'coleco -cart ' for mess's colecovision emulation. Notice the additional space after the last letter in these examples. Emuoption and commandline options accept variables (field 2= $02) that reference the contents of fields of a gamelist entry.|
altmame||#editable|The alternative emulator executable is chosen if one of these entry's corresponds to the 2,5,6 and 21 position from an entry of a game in a gamelist, that is for mame the rom name, rom of...neogeo etc., or driver...cps2.c etc. For other emulators you can create your own... I suggest using entry position 21 with something like usealtemu...|
--
runmethod|normal|normal,hidden,minimised,maximised|Options are normal, hidden, maximised, minimised. Use hidden to hide those dos/commandline boxes...for example for mame...|
runstopsound|true|#boole|When set to true the background sound will stop while you run a game. I like to keep the background sound running while I play mame games. Use the win32 not the dos version. It gives the feel of being in an arcade while playing :-)|
runstopmusic|true|#boole|When set to false the jukebox mp3's will continue playing after launching a game.|
runbefore||#fullexe|Format: commandline/runmethod/wait. Run an executable before the emulator to be launched by using normal,hidden, minimised or maximised and either wait (true) or don't wait (false) for its execution to be finished. The commandline accepts variables (field 2= $02) that reference the contents of fields of a gamelist entry.|
runafter||#fullexe|Format: commandline/runmethod/wait. Run an executable after the emulator to be launched by using normal,hidden, minimised or maximised and either wait (true) or don't wait (false) for its execution to be finished. The commandline accepts variables (field 2= $02) that reference the contents of fields of a gamelist entry.|
runexe||#editable|When the krunexe key is hit the fe will launch the application that is setup in this property. Format: commandline/runmethod/wait/runstopmusic. The commandline will be launched by using normal,hidden, minimised or maximised and either wait (true) or don't wait (false) for its execution to be finished. When runstopmusic is set to true the background sound will stop until the fe gets focus again. The commandline accepts variables that reference the contents of fields of a gamelist entry. For example $02 will add the romname of the selected game to the commandline. c:\cpviewer.exe $02 for donkey kong will become c:\cpviewer.exe dkong.|
--
noquotes|false|#boole|When the emulator does not like the game name wrapped in quotes set this option to true.|
outputcl|false|#boole|When this item is set to true, the frontend will output the commandline to lastcloutput.txt in the frontend folder.|
--
txtformat|$01 made by $04 in $03 genre $07 ($cg/$tg)|#editable|Used to format the text message when you select a game, for example $01 made by $03. $01 will be replaced with the contents of field 1 and $03 will be replaced with the contents of field 3 of the selected games gamelist entry. Use $br to insert line breaks.|
speechformat|$01|#editable|Used to format the speech message, overrules txtformat, when you select a game, for example txtformat,$01 made by $03. $01 will be replaced with the contents of field 1 and $03 will be replaced with the contents of field 3 of the selected games gamelist entry.|
infoformat|Game: $01
Year: $03
Manufacturer: $04
Category: $07
Available: $09
Times Played: $30
Minutes Played: $31
Player(s): $23
Controls: $21
Button(s): $22
Coin(s): $24
Video: $14
Orientation: $15
Resolution: $16
Aspect: $17
Frequency: $18 hz
Stereo: $20
Driver: $25
Driver Status: $26
Sound Status: $27
Color Status: $28
Links: $29
Official Mame SiteMameworldKiller List of Video Games (klov)|#editable|Used to format the information message when you select a game in the info screen or chat field, for example $01 made by $03. $01 will be replaced with the contents of field 1 and $03 will be replaced with the contents of field 3 of the selected games gamelist entry. Use $br to insert line breaks. Also supports basic html formatting. For example hyperlinks. Hyperlinks don't work when the text method is set to field.|
truncatename|(|#editable|Remove all text to the right of these characters from the descritive name. Useful to eliminate all those set names with ( then Galaga (set1) will become Galaga, or for roms renamed with the good utilites, use [, or use more then one sepetated by spaces like this ( [.|
--
fakemouseclick|false|#boole|If the fe does not get proper focus back after running a game this option can help by sending a fake click on the frontend window.|
renderfix|general|true,false,general|True and false overrule the general setting in fe.cfg. Set this to true when you see the renderer switch back to software mode after running a game and you can't use a different renderer. The textures will have to be reinstantiated again so you may see a slowdown until you have made a complete spin. Seems to happen only with dx and not with opengl. Alternatively keep this to false and set mame to not switch resolutions if you can live with that.|
)
