gemus_script_reference:functions:run_gamefile []

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
Back to [[.:|Script Function Reference]]

====== Run_GameFile() ======

Similar to the [[.:run_emulator|Run_Emulator()]] function, this function will run the game file, not the configured emulator. Any command line arguments that have previously been set using the [[.:add_clp|Add_CLP()]] or [[.:add_clp2|Add_CLP2()]] functions will be applied to this function provided that the game file's type is .exe, .com or .bat).

===== Syntax =====

<code>Run_GameFile([DOSCLOSE])</code>

===== Arguments =====

^ Argument ^ Required ^ Description ^
| //DOSCLOSE// | No | If the literal string //DOSCLOSE// is supplied as a function argument and the game file runs in MSDOS mode, the DOS command window will be automatically closed when the game file closes. You should only supply this parameter if the game file runs in MSDOS mode. |
\\ 

===== Examples =====

<code>
Run_GameFile()

Run_GameFile(DOSCLOSE)
</code>

===== Remarks =====

  * If the game file's type is .exe, .com or .bat, then it will be treated as an executable file and simply run normally. For all other file types, the game file will be run using its default program as determined by its Windows file association (e.g. if the game file is a text file, it might be opened in notepad.exe).
  * On some systems, running programs in MSDOS mode restricts the command string to a certain length. If you find that the game file will not execute, try reducing the length of the command line arguments. A common reason for this is because you have added a path to the command line arguments which is too long or has too many subfolders.

===== See Also =====

  * [[.:run_emulator|Run_Emulator()]]
  * [[.:run_emulator_send_keys|Run_Emulator_Send_Keys()]]
  * [[.:run_program|Run_Program()]]
  * [[.:|Script Function Reference]]