# # # RunPathFilename - Specify the emulator executable here. # # With regards to the directory the emulator executable will # be started in, either specify a full path as part of the # RunPathFilename value or no path at all. # # Relative paths should not be used as the behaviour may # differ with each front-end (for some, the cmd.exe "Start In" # directory is the directory that cmd.exe resides in, for # others the cmd.exe "Start In" directory is the directory # that the front end is run from). # # If a path is specified as part of the RunPathFilename value, # then it will be the "Start In" directory for the emulator. # # If no path is specified as part of the RunPathFilename # value, then the "Start In" directory will be the same # directory that cmd.exe resides in. # # Defaults to "" if not specified. # # # RunParams - The parameters that will be passed to the emulator exe # specified in RunPathFilename. This can be any free form # text. # # The following tags can be used within this string: # # $ROM - Will be replaced with the full rom # file name (including path) # # $ROM_SHORT - Will be replaced with the rom file name # but with no path or extension. # # $OTHER - Will be replaced with the appropriate # string from the [REPLACE_OTHER] section, # or nothing, if no mapping from $ROM_SHORT # in the [REPLACE_OTHER] section. See below # for further details. # # The above tags can be within quotes. The quotes will be # copied to the generated command line. # # Defaults to "$ROM" if not specified. # # # Run - During testing, you may not want to exercise the generated # command line, you may just want to check the log file # instead. # Use this flag to indicate if the generated command line # should be executed or not. # # 1 - Yes # 0 - No # # Defaults to 1 if not specified. # # # QuitKeycode - If Quit=1, then the exit key code (in decimal) can be # specified here. When the wrapper detects the key code, it # will terminate the spawned executable. # Refer to keycodes.txt for a list of virtual key code values. # # Defaults to 27 (ESC) if not specified. # # # QuitSleep - The amount of time in milli-seconds (ms) that the wrapper # will sleep for, between checking if the 'exit' key has been # pressed. # # 1 ms = 1000th of a second, so 1/2 a second is 500ms. # # Defaults to 100ms (0.1 second) if not specified. # # Note, that you would typically not need to adjust this # value. If the wrapper misses the 'exit' key being pressed, # and the spawned executable quits itself, the wrapper will # detect this, and then exit. # # # Quit - Used to specify wether the wrapper should terminate the # spawned executable or not. Typically you would use this if # the key you want to use to exit the emulator isn't available # from your control panel (or isn't the one that you would # prefer to use). # # 1 - Yes # 0 - No # # Defaults to 0 if not specified. # # # The [REPLACE_OTHER] section can be used to specify replacements for # $OTHER on a per-rom basis, as follows: # # = # # is the $ROM_SHORT value to key on, will replace $OTHER # in the RunParams string. # # This allows individual emulator parameters to be specified per rom. # RunParams could be set to just $OTHER or a combination of possibly $ROM, # $ROM_SHORT, $OTHER and common parameters. # # [GENERAL] RunPathFilename= RunParams= Run= QuitKeycode= QuitSleep= Quit= [REPLACE_OTHER]