Running JSFL files

There are several ways to run JSFL files. The most common ways are explained in this section.

To run a script that is in the Commands folder, do one of the following:

Select Commands > Script Name.
Use a keyboard shortcut that you have assigned to the script. To assign a keyboard shortcut, use Edit > Keyboard Shortcuts and select Drawing Menu Commands from the Commands pop-up menu. Expand the Commands node in the menu tree to view a list of available scripts.

To run a command script that is not in the Commands folder, do one of the following:

From the authoring environment, select Commands > Run Command, and then select the script to run.
From within a script, use the fl.runScript() command.
From the file system, double-click the script file.

To add a tool implemented in a JSFL file to the Tools panel:

Copy the JSFL file for the tool and any other associated files to the Tools folder (see Saving JSFL files).
Select Edit > Customize Tools Panel (Windows) or Flash > Customize Tools Panel (Macintosh).
Add the tool to the list of available tools.
Click OK.

You can add individual JavaScript API commands to ActionScript files by using the MMExecute() function, which is documented in the ActionScript 3.0 Language Reference. However, the MMExecute() function has an effect only when it is used in the context of a custom user-interface element, such as a component Property inspector, or a SWF panel within the authoring environment. Even if called from ActionScript, JavaScript API commands have no effect in Flash Player or outside the authoring environment.

To issue a command from an ActionScript script:

Use the following syntax (you can concatenate several commands into one string):
```
MMExecute(Javascript command string);
```

To run a script from the command line on Windows:

Use the following syntax (add path information as required):
```
"flash.exe" myTestFile.jsfl
```

To run a script from the "Terminal" application on the Macintosh:

Use the following syntax (add path information as required):
```
osascript -e 'tell application "flash" to open alias "Mac OS X:Users:user:myTestFile.jsfl" '
```
The osascript command can also run AppleScript in a file. For example, you could put the following text in a file named myScript:
```
tell application "flash"
  open alias "Mac OS X:Users:user:myTestFile.jsfl"
end tell
```
Then, to invoke the script, you would use this command:
```
osascript myScript
```