mGalaxy documentation

Adding script to support an emulator

What is a script and why use it! #

When using an emulator with mGalaxy, 2 criteria are induced:

  • the emulator must be able to run in full screen.
  • you must be able to exit the emulator by pressing the ‘ESC’ key.

Sometimes an emulator will not allow to specify one or all of these 2 settings in the application. In this case, you need a ‘script’ to assist the emulator.

A script is a small piece of software between mGalaxy and the emulator to execute tasks that are not natively provided by the emulator.

mGalaxy comes with all the necessary scripts pre-installed but if you need to add an emulator not yet recognized by mGalaxy and also the necessary script, here is how to proceed.

The script must be located in the “Scripts” folder of mGalaxy and have exactly the same name as the one given to the emulator. Finally, you must make sure that the system informing this emulator (and therefore the corresponding script) has the box “Use script file if available” checked.

Creating a script with ‘AutoIt’ #

AutoIt is a freeware BASIC-like scripting language designed for automating the Windows GUI and general scripting. It uses a combination of simulated keystrokes, mouse movement and window/control manipulation in order to automate tasks.

• First you will need to download and install the AutoIt freeware here.

• Create a script that must start with the code below.

• We can’t give you a programming course here and we urge you to take the necessary knowledge (Learning to script with autoit v3) by starting, for example, by examining how the scripts in the “Scripts” folder of mGalaxy are written.