Creating Scripts

T-HSCP-001-002

You can create scripts for Harmony by using the Script Editor view.

TIP To help familiarize yourself with Harmony scripts, you can open the Script Editor view and look into the TB_sceneCreated script. This script is automatically executed when you create a scene. By default, it sets the scene's length to 60 frames and creates a basic layout containing a single drawing layer. You can customize this script to automatically set up scenes you create to fit your project's needs.
NOTE

User scripts are stored 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

  1. In the top-right corner of the Camera or Drawing view, click on the Add View button and select Script Editor.

    The Script Editor view is added to your workspace. It lists all the scripts packaged with Harmony as well as any script you previously created.

    Script Editor View

  1. Do one of the following:

    • In the Script Editor toolbar, click the New Script button.
    • In the top-left corner of the Script Editor view, click on the Menu button and select select File > New Script.

The New Script dialog box appears.

New Script Dialog Box

  1. Type in a name for your script and click on OK.

    A dialog prompts you to select the location in which to create the script.

  1. In the drop-down menu, select the location in which you want to create the script:

    • 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.

    Your script is added to the list of scripts in the Script Editor.

  1. Select the script your just created in the list.

    New Script File

    You can now start editing your script in the Script Editor.

  1. Click on the text field in the right area of the Script Editor and start writing your script.

    The following is an example of a script that will display a message box saying "Hello World!"

    2. function HelloWorld() { MessageBox.information("Hello World!"); }
NOTE For information on how to use the Qt scripting language in Harmony, see About Scripting. You can also open the scripting reference guide directly from the Script Editor by clicking on the Menu button in the top-left corner and selecting Help > Scripting Interface Documentation.