Toon Boom
Storyboard Pro 22

Release Notes

TOON BOOM ANIMATION INC.

+1 514 278 8666

4200 Saint-Laurent, Suite 1020
Montreal, Quebec, Canada
H2W 2R2

contact@toonboom.com
toonboom.com

Toon Boom Storyboard Pro 22.0.3 Release Notes

Legal Notices
Toon Boom Animation Inc.
4200 Saint-Laurent, Suite 1020
Montreal, Quebec, Canada
H2W 2R2
Tel: +1 514 278 8666
Fax: +1 514 278 2666
toonboom.com

Disclaimer
The content of this document is the property of Toon Boom Animation Inc. and is copyrighted. Any
reproduction in whole or in part is strictly prohibited.
The content of this document is covered by a specific limited warranty and exclusions and limit of liability
under the applicable License Agreement as supplemented by the special terms and conditions for

Adobe®Flash® File Format (SWF). For details, refer to the License Agreement and to those special terms andconditions.

Trademarks
Toon Boom® is a registered trademark. Storyboard Pro™ and the Toon Boom logo are trademarks of Toon
Boom Animation Inc. All other trademarks of the property of their respective owners.

Publication Date
10-11-2023
Copyright © 2023 Toon Boom Animation Inc., a Corus Entertainment Inc. company. All rights reserved.

1

Table of Contents

Table of Contents
Table of Contents

2

Storyboard Pro 22.0.3 Release Notes

3

Storyboard Pro 22.0.2 Release Notes

5

Storyboard Pro 22.0.1 Release Notes

7

Storyboard Pro 22 Release Notes

92

Toon Boom Storyboard Pro 22.0.3 Release Notes

Storyboard Pro 22.0.3 Release Notes
Storyboard 22.0.3, build 21960 (2023-09-13)

Fixes
The following issues are fixed in this release of Storyboard Pro and later.

GenerallCreating sequences using the New Sequence or Split Current Sequence commands does not work
correctly. SB-5245

l

Storyboard Pro may crash during playback if the Function Editor view is visible in the workspace. SB5268

l

Storyboard Pro may be unable to read drawings created over 10 years ago. SB-5259

lUsing the Export to FBX command leaves temporary PNG renders of drawing layers in the tmp folder.
SB-5197lAnimated layers may not export properly to Harmony if they are animated using 3D Path functions. SB5260

l

Storyboard Pro crashes if it fails to load internal libraries on startup. SB-5278.

Audio
l

Audio playback fails with the following message “Cannot start the playback system: Invalid Device"when attempting to play voice annotations while using specific audio devices or headsets as output
devices on Windows. SB-5074

lRandom pops and tics can be heard during playback on Windows. SB-5198

lThere is no sound when exporting movies to H.264 or exporting to Harmony if Storyboard Pro is in
Spanish. SB-5249

lAudio clips that are sped up may not play or export properly if their Waveform is displayed in theTimeline. SB-5183

lRecording audio after resizing a panel may cause a crash. SB-5274

Scriptingl

Storyboard Pro crashes when running a script using the MotionManager.setLayerAnimated function inbatch mode. SB-5252

3

Storyboard Pro 22.0.3 Release Notes

Scripting Improvements
Import Animatic Scripting Interface
The ImportManager class has been added along with the importAnimatic function to allow automation of theImport Animatic Project command used for conformation. The importAnimatic function can only be used while
the UI is displayed and cannot be used in batch mode. Please refer to the Scripting Interface documentation for
more information.
https://docs.toonboom.com/help/storyboard-pro-22/storyboard/scripting/reference/classImportManager.html

Adding and Removing Groups Using Scripting
The following new functions for identifying, adding and removing groups and layers in groups have been
added to the LayerManager class:l

addGroupLayerlgroupOfLayerl

isGroupLayerlmoveLayerBeforeLayerlmoveLayerInGroup

Please refer to the Scripting Interface documentation for more information.
https://docs.toonboom.com/help/storyboard-pro-22/storyboard/scripting/reference/classLayerManager.html

Improved layer selection in the LayerManager Class
The following changes were made to the LayerManager class to make it easier to select and manipulate layers
through scripting:
The new layerIndexFromName function in the LayerManager class was added to easily find the index value ofa layer based on its name.
The following commands now allow selecting layers based on either their index or name:lisEmptyl

isSharedlmergeLayerslgenerateMatteLayer

Please refer to the LayerManager class in the Scripting Interface documentation for more information.
https://docs.toonboom.com/help/storyboard-pro-22/storyboard/scripting/reference/classLayerManager.html

4Toon Boom Storyboard Pro 22.0.3 Release Notes

Storyboard Pro 22.0.2 Release Notes
Storyboard Pro 22.0.2, build 21617 (2023-06-12)

Fixes
The following issues are fixed in this release of Storyboard Pro and later.

TimelinelSelecting keyframes in the Camera or Layer Animation tracks doesn’t work every time. SB-5151l

A template created from multiple clips may corrupt the project when dropped in a video track. SB4504l

If an audio clip ends under the last panel of a scene, changing the duration of this audio clip using the
Speed/Duration command with the Ripple Edit option enabled will not adjust the panel correctly. SB5208

l

Using the ‘Split Panel at Current Frame’ command may cause a crash. SB-5038

lStoryboard hangs in some conditions when stopping the audio playback. SB-5185

Drawing WorkflowlLines are not always drawn at full precision after pulling the stylus away from the tablet. SB-4818

lPasting a drawing object does not paste it at the proper location if there is an offset on the source layer.
SB-5192l

Copying a drawing from the Camera view and pasting it while in the Thumbnails or Timeline view as
focus will paste it in the center and not the original position. SB-5209

lDrawing does not work in the Camera View after generating a PDF Preview. SB-5026

lTyping Japanese or Korean with the Text tool does not work. SB-5063

3D
lWhen converting a 3D model to 2D, the render in the Render 3D Model window does not take into
account the project’s Field Chart setting. SB-5191

l

The preview in the “Render 3D Model to 2D” dialog always uses a 16:9 aspect ratio regardless of the
project’s resolution. SB-4452

l

2D Layers that are rotated in 3D will disappear from the Camera view when the angle of the layer isclose to being perpendicular to the camera. SB-5062

5

Storyboard Pro 22.0.2 Release Notes

Import/Exportl

Double and single quotation marks are converted to question marks when importing a Final Draft
document. SB-5186

lWith certain scenes the incorrect movie clip frame range is exported to Harmony when the Export Typeis set to Original Scene. SB-5210

l

Audio export fails when language is set to Spanish. SB-5089

Conformationl

Exporting to AAF for conformation fails with error "AAF internal error. 0x-7ff8ff82" on some systems.
SB-5088lRendered images for panels that don't have camera motion will have the wrong size if the project FOV
is not set to Vertical and the Rectify Static Camera option is enabled. SB-5160

Performancel

Storyboard Pro crashes out of memory when rendering a project that contains HD videos. SB-5109

l[Windows] Some projects can take an unusually long time to save. SB-5139

lStoryboard randomly crashes on some systems using Windows 11. SB-4786

6

Toon Boom Storyboard Pro 22.0.3 Release Notes

Storyboard Pro 22.0.1 Release Notes
Storyboard Pro 22.0.1 build 22.0.1.19025 (2022-11-24)

Fixes
The following issues are fixed in this release of Storyboard Pro and later.

Drawing Toolsl

Stroke colour is lost when undoing and redoing cut and pasted strokes. SB-4900

Timeline and Playbackl[Windows] Playback can get stuck when Loop and Sound are enabled. HAR-8808

lUsing the Split Panel At Current Frame command on a duplicated scene may cause a crash when there
are two instances of the same project open in memory. SB-4910

Video Tracks and Clipsl

Opacity isn’t applied to a stroke created in a video clip layer until the stroke is done. SB-4898

l

The Set Colour menu option does not work for New Empty Clips and Image Clips. SB-4909

PDF Exportl

Crash when exporting to PDF when Display Selected Caption is enabled. SB-5012

ScriptinglRunning scripts from the command line without the -batch parameter will crash. SB-5004l

Text is not exported when exporting a PDF by using a command line script. SB-5003lImporting a PSD with LayerManager::importImageAsLayer pops up a redundant multi layer message.
SB-4413lExportManager::exportToHarmony does not work in batch Mode. SB-4013

l[macOS] The Help menu disappears after closing a project and reopening another one. SB-4588lKeyboard shortcuts no longer work when the mouse focus is in a caption field in the Panel view. SB-

UI

4858

7

Storyboard Pro 22.0.1 Release Notes

Import / Exportl[Windows] Missing frames and other issues when importing short movies. SB-4926

l

3D models or movie clips disappear from the scene if the file name ends with a v and three digits (v001). SB-4129

l[macOS] Storyboard does not work with the LucidLink cloud NAS file system. HAR-8806

Performancel[macOS] With certain projects exporting a movie may cause the system to run out of memory. SB-4985

l[macOS] Storyboard Pro sometimes crashes when waking from sleep mode. SB-4973

Devicesl[Windows] Eraring using a Wacom pen button mapped to the Erase function does not work if Qt
Wintab Tablet Support is enabled in the Storyboard Pro Preferences. SB-4915

lTouch gestures for zoom, pan and rotate do not work with Surface Pro, XPPen and Wacom Cintiq
devices. SB-4792

Other FixeslDisabling the Transform Tool Uses Drawing Pivot option in the Preferences causes Storyboard Pro to
crash on startup. SB-4936

l[macOS] Typing Chinese or Japanese characters in a panel caption does not work until after a menu is
opened. SB-4997

Known IssueslWhen there’s not enough space to display all buttons in a toolbar, the extension that is opened toaccess the buttons will be hidden under views that use OpenGL. HAR-8186

lStroke remains in place after removing the last point of a branch with the centreline editor. SB-4455lWhen using an iPad Pro in Sidecar mode with Storyboard Pro, every second click registers as a doubleclick. SB-4941

lUpdating the operating systems to macOS Ventura may help fix this issue.

lOn macOS Mojave, GateKeeper prevents launching Storyboard Pro unless the quarantine extended
attribute is removed from the application bundle. SB-4428

The quarantine extended attribute can be removed using the following command in the Terminal:$ sudo xattr -dr com.apple.quarantine "/Applications/Toon Boom Storyboard Pro
22"8

Toon Boom Storyboard Pro 22.0.3 Release Notes

Storyboard Pro 22 Release Notes
Here is the list of changes in Storyboard Pro 22, build 22.0.0.18846 (2022-09-28)l

New FeatureslDrawing Toolsl

Reference Viewl

CameralTimeline

l

Audio

l

ConformationlRenderingl

Library

l

Fixes

l

Known Issues

New Features
Drawing Tools
FeatureMirror View

Description

You can now temporarily flip the contents of the Camera and Stage viewshorizontally by enabling Mirror View mode. This helps artists have a different
perspective on their artwork. It makes it easier to view the balance andcomposition of a drawing and helps to spot mistakes.
To enable Mirror View, click on the

Mirror View button in the Camera orStage view toolbar, or select View > Mirror View from the top menu.
For more information, see About Mirror View.

Live Preview When Drawing
with a Textured Pencil

Artists can now see the texture on pencil lines as the line is being drawn,
providing a live accurate preview of the final line. In the past, the pencil line
would be solid while drawing and the texture would appear once the line isdrawn.

New Brush Tool Properties

To give you more control over the look and feel of the brush tool, new options
are available to dynamically control the size, flow, opacity and brush tip angle
when using a drawing tablet.

9

Storyboard Pro 22 Release Notes

FeatureDescription

Size, Flow and Opacity
Pen tilt and drawing speed can now be used as inputs to change the Size, Flowand Opacity properties of brushes, making it possible to control the size andthe opacity of brushes independently while drawing. You are not limited tousing the pressure for both.
Fading and tapering parameters can also be used to increase or decrease thevalue of these properties based on the length of strokes.
The additional properties are available in a new window found by clicking thearrow next to those properties. A combination of multiple inputs from the pen
can be used to control a single property.

Brush Tip Orientation
The orientation of the brush tip can now be dynamically controlled using morethan just the Wacom Art pen twist. A new drop-down list, in which you canselect between Constant, Heading, Azimuth and Twist, is now available next
to the Angle Function property.
For more information, see Brush Tool Properties.

Scale Pencil Line Thickness

A new option named Scale Pencil Line Thickness has been added to the SelectTool Properties.

10

Toon Boom Storyboard Pro 22.0.3 Release Notes

FeatureDescription

When enabled, the thickness of lines created with the Pencil tool or any of the
shape tools will scale when using the Select tool to transform them.

Deselecting Multiple Strokes

It is now possible to deselect multiple strokes from the selection when using
the Select tool by holding down the Shift+Alt keys (Shift+Option on macOS).
This allows you to quickly remove multiple strokes from a selection without
having to click each of them individually.

Reference View
FeatureDescription

The Reference view (formerly known as the Model view) can now be used toimport and display bitmap images that can be used as inspiration or as
references while drawing.

Updated Model view, now
renamed Reference View
Imported images are automatically saved in the project’s models folder. These
reference images can then be loaded on demand in subsequent sessions using
the Load Default References command.
The new Delete Current command has been added to the view to allow
deleting images from the project's models folder, without having to manually
delete using the file browser.
You can now import images and drawings into the Reference View using dragand-drop from a file browser or by pasting images from the clipboard.

11

Storyboard Pro 22 Release Notes

CameraFeatureDescription

Reframe Static Camera

Some artists use a static camera to adjust the frame of a scene after they havedrawn the artwork. This does not impact the storyboard pipeline too much but
can cause problems further down the production pipeline when exporting toHarmony. It also causes issues when flipping between scenes and looking atthem in the Stage View.
A new command in the Camera menu called Reframe Static Camera allows
users to reset the position of the static camera in a scene while repositioning
the drawings to preserve the composition.

Timeline
FeatureDescription

While dragging a clip from a video track to the Storyboard track there is now agreen bar indicating where the video clip will be dropped.
New Drop Position Feedbackin Storyboard Track

Audio
FeatureDescription

Audio Levels View

The new Audio Levels view provides a graphical indicator of the average
decibel (dB) level as output in the final mix. The left and right audio channels
are represented as bar graphs that update in real time during playback or
scrubbing.
The bar graphs will automatically orient horizontally or vertically depending on
the aspect ratio of the Audio Levels view.

Preference to select Audio
Output Device

The Audio Output Device option that is located in the Playback tab of thePreferences has been improved and now lists all available devices on thesystem. This allows Storyboard Pro to use a different audio device than the one
set as the default in the operating system.

12

Toon Boom Storyboard Pro 22.0.3 Release Notes

Conformation
FeatureNest scenes containing camera
motionDescription

The new Nest scenes containing camera motion option, available in the Export
Project dialog, nests panels from scenes that have camera movements andplaces the camera keyframes, converted to a motion effect, on the nest. Thisreplicates the scene level camera that is in Storyboard Pro and does not breakthe camera movement on individual clips like in previous versions. This allows
changing the duration of clips within a scene without breaking the camera
movement when it spans across multiple panels.

3D scene conformation

Use the Scene Reference track
to conform scenes

Basic conformation of scenes with 3D camera movement is now possible with
Storyboard Pro 22. As NLE software do not support 3d camera motion, when a
3D scene is exported as part of a conformation export, the first frame of eachpanel will be rendered as seen through the camera and used for each clip inthe exported timeline. This allows the position and duration of clips to bechanged in the NLE software and have those changes conformed back in
Storyboard Pro 22.
A new option named Use the Scene Reference track to conform scenes isavailable in the Import Project dialog. This option allows better tracking ofscene names and positions when conforming changes back from editing
software using the scene reference track.

Timeline Markers

Markers in the project’s timeline are now included when exporting a project for
conformation. A new option named Process Markers is now available to importthose markers back into Storyboard Pro when importing an animatic project

Clip Handle Duration

A new option to set the duration of clip handles when exporting forconformation is available in the Export Project dialog.

Create Layers from PSD files

A new option named Create Layers from PSD files is now available in the
Import Project dialog. When enabled, Storyboard Pro will create individual
layers when a new panel is created from a PSD file that is not from an existing
panel in the current project. Previously, PSD files would be imported as flat
images when imported through the conformation process.

3DWarp effect in AAF exports

3DWarp effects are now only added to scenes that have camera motion whenexporting an AAF.

13

Storyboard Pro 22 Release Notes

Rendering
FeatureApple ProRes Codec Support
For Windows

Description

Apple ProRes codecs are now packaged in Storyboard Pro 22, allowing theuse of the same high quality codec on Windows and macOS platforms.
The new QuickTime ProRes Movie format is available in the Export to Movieand Export to EDL/AAF/XML dialogs.

Library
FeatureDescription

Library View Thumbnails

The Library view Thumbnail display mode has been improved with the additionof a slider, placed on the bottom right of the view, that can be used to change
the thumbnail sizes.
Filenames are now written below the thumbnails to allow them to align in agrid fashion.

Fixes
The following issues have been fixed in this release of Storyboard Pro:

Generall

Crash when rendering a scene with a specific 3D model. SB-4830

lRandom crashes when using the Create Layer on Surface tool. SB-4817

lRandom crash when making multiple strokes with thumbnails visible. SB-4814

l

Layers that are beyond 12 F on the Z axis disappear from the camera view when the camera is rotatedin 3D. SB-4811

lLayers do not follow the camera when Layer Alignment is set to Pin To Camera. SB-4810

lShortcuts are not listed in views and contextual menus on macOS. SB-4798

lPerformance drops when resizing the panel in the Timeline if video track synchronisation is enabled.
SB-4564l

Antialiasing is missing in the Camera and Stage view Overlays. SB-4417l

A Crash occurs when stopping playback and the Black Magic device is set in preference but notconnected. SB-4135lPreferences from previous versions are not migrated. SB-4808

14

Toon Boom Storyboard Pro 22.0.3 Release Notes

Drawingl

Shape tools are not antialiased while drawing. SB-4730

lTransform controls do not switch immediately to the selected and visible layer. SB-4705lLines are not drawn at full precision when using a Wacom tablet and changing applications using
ALT+TAB on Windows. SB-4613

TimelinelAnimatic Editing Mode is ignored when dropping a video clip between panels or at the end of the
Storyboard track. SB-4155

l

On Windows, the first playback randomly stops and loops audio while audio files are being
decompressed. SB-3933

lMulti-Track: Set Colour is missing in the right-click contextual menu for video tracks. SB-1811

Import / Exportl

SBP may consume huge amounts of memory when exporting movies. SB-4799

lUsing the %f variable in the file pattern doesn't work when using Export to Movie.SB-4837

l

The Display Vectorize Option Dialog preference does not work when importing a bitmap to a video
track. SB-4835

l

An extra frame is created when importing a specific MP4. SB-4829

lLarge JPEG images do not import. SB-4788

MarkerslMarkers don’t ripple when a Scene or Sequence is dragged.SB-3563

lMarkers don’t ripple when changing transition duration. SB-3483

ConformationlImport Animatic Project removes free space at the beginning of the timeline. SB-3230lImport Animatic Project fails if there are unsupported media files (m4a) linked in the XML.SB-2747

lCannot overwrite AAF file when exporting a project for conformation. SB-4863

l

Macs with Apple Silicon don’t support AFF conformation. SB-4802

Scriptingl

The default colour is not used when using SBU_LayerScriptInterface.generateMatte() from scripting.
SB-485015

Storyboard Pro 22 Release Notes

Known IssueslWhen there’s not enough room for all the buttons in a toolbar, the extension that can be opened toaccess the buttons is hidden when it opens over an OpenGL view. SB-4530

lTouch Gestures to zoom, pan and rotate don't work on Windows. HAR-8739

lSB-4428 On macOS Mojave, GateKeeper prevents launching the Storyboard Pro unless the quarantine
extended attribute is removed from the application bundle. The quarantine extended attribute can beremoved using the following command in the Terminal:
sudo xattr -dr com.apple.quarantine "/Applications/Toon Boom Storyboard Pro
22"16