Script Editor View

The list of script files available as well as their location and their read and write permissions. Selecting a script in this list will open it in the editor.

The file list has three columns: File, Location and Permissions.

• The File column indicates the filename of each script.

  NOTE The << Sandbox >> item at the top of the list does not correspond to an actual script file. It is a temporary container to type and test code, and its content cannot be saved.

• The Location of the script can be one of the following:

  • Application Folder: Scripts that are packaged and installed with Harmony. By default, you cannot edit these scripts until you select them and click on Make Editable, at which point you are prompted to copy the script to a location from which you can edit them.

    Scripts in the Application Resources folder are in the following location:

    • Windows: C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony 20 Essentials\resources\scripts
    • macOS: /Applications/Toon Boom Harmony 20 Essentials/Harmony Essentials.app/Contents/tba/resources/scripts

  • User: Scripts that are saved in your user preferences. Those scripts can be edited and executed from any scene, provided that you are logged in as the same user.

    Scripts in the User folder are in the following location:

    • Windows: C:\Users\[username]\AppData\Roaming\Toon Boom Animation\Toon Boom Harmony Essentials\2000-scripts
    • macOS: /Users/[username]/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Essentials/2000-scripts

  • Scene: Scripts in the scripts sub-folder of the currently open scene. These scripts can only be edited and executed when the current scene is open.

  • System Variable: Scripts inside the directory set in the TOONBOOM_GLOBAL_SCRIPT_LOCATION environment variable, if this variable is set. These scripts can be edited and executed by anyone on your workstation.
  NOTE

  When two or more scripts with the same file name exist in different locations, Harmony will give priority to a single one of these scripts. The script given priority will be the one listed in the Script Editor and the one executed if it is associated to a toolbar button.

  Which script is prioritized is determined by the order of priority of script locations. From highest priority to lowest priority, the order goes as follows:

  User > Scene > System Variable > Application Resources

  An exception to this rule is if you have a script with the same name in both the scene folder and your user preferences. In this case, both versions of the script will be listed and you will be able to edit both.

• The Permissions of the script can be one of the following:

  • Read Only: You cannot edit the script in the Script Editor and save your changes.

    NOTES

    • If the script's location is the Application Resources folder, it will always be Read Only to prevent you from making changes to scripts packaged with Harmony. However, you can click on the Make Editable button below the script editor to make a copy of the script in your user preferences folder, after which you can make changes to this copy.
    • If the script is in any other location and is Read Only, then it is likely that a network administrator made the script or the folder containing the script read-only to prevent other users from making unwanted changes to it.
  • Read/Write: You can edit the script in the Script Editor and save your changes.

A text field in which you can edit the selected script.

Allows you to type in a keyword and search for this keyword within the script. You can use the Next button to go to the next instance of the keyword and the Previous button to go to the previous instance.

If the selected script is a script that was packaged with Harmony, and which you copied to your User folder or to the Scene folder to make changes to it, you can click on this button to delete this copy of this script and resume using the original version of the script that is packaged with Harmony instead.

Verifies that the script has no syntax error.

If the currently selected script is in the Application Resources folder, you cannot edit it. By clicking on this button, the script can be copied to a location where you can edit it.

When you click on this button, you are prompted to choose whether to copy in either of these locations:

• User: Saves the script to a directory in your user preferences directory. You will be able to run and edit the script from any scene as long as you are logged in as the same user.

• Scene: Save the script to the scene's scripts sub-folder. Anyone will be able to edit and run the script when working on this specific scene.
• System Variable: Save the script to the directory in the TOONBOOM_GLOBAL_SCRIPT_LOCATION environment variable. This option is only available if this environment variable is set.