User Tools

Site Tools


gemus_script_reference:functions:run_gamefile

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

gemus_script_reference:functions:run_gamefile [2020/05/12 11:27] (current)
Jimbo created
Line 1: Line 1:
 +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]]
gemus_script_reference/functions/run_gamefile.txt · Last modified: 2020/05/12 11:27 by Jimbo