Scripting

In the past, scripts packaged with Storyboard Pro were all automatically copied to your preferences folder, in the same location as your custom scripts. Now, scripts packaged with Storyboard Pro are only copied to your preferences if you make modifications to them. Otherwise, they are stored and executed from the Storyboard Pro installation folder.

This solves several problems:

• The scripts folder in your user preferences is now reserved for your custom scripts and are no longer cluttered with Storyboard Pro scripts.
• In previous versions, when installing a patch update, Storyboard Pro would not overwrite the scripts in your user preferences with the updated scripts, as this would risk overwriting one of your user scripts. This is no longer a problem, except in the rare case where you happen to have edited a script packaged with Storyboard Pro which was updated in a patch update.
• You can now easily restore the original version of a packaged Storyboard Pro script after having made changes to it.

You can now set a custom location in which to store scripts. To do this, you must set the TOONBOOM_GLOBAL_SCRIPT_LOCATION environment variable to the location where you want to store scripts. The scripts in this location will be available in the Script Editor alongside scripts that are packaged with Storyboard Pro and scripts in your user preferences.

It is now possible to export your project as an EDL, AAF or XML sequence through scripting. You can do this by using the exportToNLE() method of the ExportManager class.

The setOneMoviePerPanel() method was also added to the ExportManager class to support exporting one movie file per panel.

Storyboard Pro Scripting Reference

The following methods were added to the scene class to convert the coordinate for a single axis from field coordinates to OpenGL coordinates, and from OpenGL to field coordinates: toOGLX(), toOGLY(), toOGLZ(), fromOGLX(), fromOGLY() and fromOGLZ()—see Storyboard Pro Scripting Reference.