Toon Boom
Harmony 20
Release Notes

TOON BOOM ANIMATION INC.

+1 514 278 8666

4200 St.Laurent Blvd, Suite 1020
Montreal, Quebec, Canada
H2W 2R2

contact@toonboom.com
toonboom.com

Toon Boom Harmony 20.0.6 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 theapplicable 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 and conditions.

Trademarks
Toon Boom® is a registered trademark. Harmony™ 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-03-2023
Copyright © 2023 Toon Boom Animation Inc., a Corus Entertainment Inc. company. All rights reserved.

1

Toon Boom Harmony 20.0.6 Release Notes

Table of Contents
Table of Contents

2

Toon Boom Harmony 20.0.6

3

Toon Boom Harmony 20.0.5

4

Toon Boom Harmony 20.0.4

5Toon Boom Harmony 20.0.3

7

Toon Boom Harmony 20.0.2

11

Toon Boom Harmony 20.0.1

12Toon Boom Harmony 20.0.0

132

Toon Boom Harmony 20.0.6 Release Notes

Toon Boom Harmony 20.0.6
Here is the list of changes in Harmony 20.0.6, build 19420 (2023-08-17):
NOTE
The Python plugin, which allows Python 2.7 scripts to be run from Harmony, no longer loads by default on
macOS Big Sur and Monterey. You can force the Python plugin to load by enabling the FORCE_LOAD_PYTHON_SCRIPT hidden preference.

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

Generall

Scene locks are not always released when closing Harmony. HAR-8092

lShift+B to navigate down the hierarchy is blocked by Transformation Switch nodes. HAR-7886

l“Unable to read” tvg file message appears when opening a scene that contains drawings that have been createdon a system that has a license that dates back over 10 years. HAR-9358

Database / Control CenterlImporting multiple scenes in the same operation is critically slow. HAR-8020lPalettes are locked during batch renders if colours are being recovered. HAR-8536

Import / Exportl

PSD files saved with Adobe Photoshop 2021 or later are blank once imported. HAR-8835

Renderingl

Weighted Deform sometimes produces incorrect results when rendering in batch. HAR-8139

ScriptinglColour modifications using Color.setColorData are not saved. HAR-8112

laddNodeToSelectionNode, addNodesToSelectionNode and removeNodeFromSelection in theselection class do not work with backdrops correctly. HAR-8391

Utilitiesl

Brush textures are ignored when copying a TVG to an art layer using utransform’s Art Layer options. HAR-7809

l

New keepTexture option added to Pix2vec’s 4 colour vectorization to preserve brush textures. HAR-7918

3

Toon Boom Harmony 20.0.6 Release Notes

Toon Boom Harmony 20.0.5
Here is the list of changes in Harmony 20.0.5, build 20.0.5.17671 (2021-11-04):
NOTE
The Python plugin, which allows Python 2.7 scripts to be run from Harmony, no longer loads by default on
macOS Big Sur and Monterey. You can force the Python plugin to load by enabling the FORCE_LOAD_PYTHON_SCRIPT hidden preference.

Fixes
The following issues have been fixed in this release of Harmony:lHarmony crashes when opening a scene in database mode on macOS Monterey. HAR-7793

lImporting scenes from a database package does not work properly when using Control Center in batch mode.
HAR-7785lHarmony crashes when opening a specific scene that contains Weighted Deformers. HAR-77404

Toon Boom Harmony 20.0.6 Release Notes

Toon Boom Harmony 20.0.4
Here is the list of changes in Harmony 20.0.4, 20.0.4.17478 (2021-09-22):lDrawing Tools on page 5lAnimation Tools on page 5lRendering and Compositing on page 5lImport and Export on page 6l

3D on page 6lControl Center on page 6lGeneral on page 6

Fixes and Changes
The following issues have been fixed in this release of Harmony:

Drawing Toolsl

The Paint tool does not work on drawings that have extremely large geometries. HAR-7624l

A hidden preference was added to allow users to lower the drawing precision and simulate the drawing
experience from Harmony 14. When the preference is enabled, Harmony will round coordinates of points received
from the mouse or drawing tablet, creating bumpier lines.

You can enable this preference by downloading, importing and running the script from the URL below:
docs.toonboom.com/go/download/ToggleDrawingToolsRoundsCoordinateslA hidden preference was added that can be used to disable smoothing of vectors when using the Perspective toolin Lattice mode.
docs.toonboom.com/go/download/ToggleLatticeToolSmoothing

Animation Toolsl

Using the Transform tool or moving up the hierarchy using B does not select the peg connected to the target portof the Transform Gate. HAR-7101

Rendering and Compositingl

The Gaussian Blur effect should only mirror pixels that are outside the camera frame when the “Repeat Edge
Pixels” option is enabled. HAR-7623

lToggling the "Repeat Edge Pixels" option in the Gaussian Blur effect node does not update the Render preview
immediately. HAR-7622

5

Toon Boom Harmony 20.0.6 Release Notesl

Rendering to QuickTime or H.264 with two instances of Harmony simultaneously may generate corrupted files.
HAR-7625l

Crash when rendering if a TVG is missing while its element node has the Transparency option disabled. HAR7129

l

Surface Normal does not work properly when a drawing is painted with a gradient colour. HAR-7059

lHarmony on Windows may crash when rendering a specific drawing drawn with brush textures. HAR-7413

Import and ExportlApple ProRes files fail to import on Windows even when QuickTime 7 is installed. HAR-7133

l

Frames are held and skipped when importing movies with 23.976 frame rate. HAR-7671l

The selected Alignment Rule is ignored when importing a PSD as a Toon Boom Bitmap with the Individual Layers
option enabled. HAR-7616

3D
lScenes with Alembic files that use RGB colour sets may cause Harmony to crash. HAR-7503

Control Centerl

Palettes at the Job and Environment levels are not imported when importing an offline scene. HAR-7606

lImporting a specific scene using the -import_scene argument from Control Center does not work. HAR-7580

GenerallRandom crash when performing various drag and drop operations under the latest Windows 10 using an NVIDIA
Quadro GPU. HAR-7491

lElements cannot be deleted using the Element Manager if used in more than one version of the scene. HAR-7128

lHarmony does not delete columns when deleting the nodes if “Delete Drawing Files and Element Folders” isunchecked. HAR-7156

lHarmony sometimes crashes when using the trackpad on a MacBook Pro. HAR-7152

lRemove Unused Files doesn’t always delete palette files from disk. HAR-7090

lHarmony crashes on rare occasions when changing the scene’s working colour space. HAR-7141

6

Toon Boom Harmony 20.0.6 Release Notes

Toon Boom Harmony 20.0.3
Here is the list of changes in Harmony 20.0.3, build 20.0.3 16743 (2021-02-09):lNodes and Compositingl

Master Controllers

l

WebCC

l

Fixes

Nodes and Compositing
FeatureDescription
A Hue Interpolation option has been added to the Colour fade node. This new option
allows selecting the type of interpolation used for the hue value and is available when the
Colour Interpolation is set to HSL or HSV. The following options are available:lColour Fade Hue Interpolation

l

l

l

Linear: Interpolates the hue value linearly between 0 and 360. Provided for legacy
reasons.
Circular Shortest: Linear hue value interpolation from the source colour to thedestination colour using the shortest distance, passing through 360 to 0, and viceversa if shortest.
Circular Clockwise: Clockwise value interpolation, wrapping around 360 to 0 if
necessary.
Circular Counterclockwise: Counterclockwise value interpolation, wrapping around
0 to 360 if necessary.

Pre-render Cache node status
in the Timeline

The Pre-render Cache node now shows green frames in the Timeline once a frame isrendered and available in the cache.

Render/Clear Current Frame

There is a new option in the Pre-render Cache node to render or clear the image in cache forthe current frame.

Master Controllers
FeatureDescription

Automatically Filter Attributes

A new option that controls whether attributes that do not change over time should be
added when creating a master controller is now available in the Stack, Grid and Slider
wizards. This new option, named Automatically Filter Attributes, will omit attributes thathas the same value for the duration of the source frame range and will not add them to the7Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription
Master Controller.

WebCC
FeatureExport Offline Options inControl Center

Hiding Library options whenexporting offline in WebCC

Description
Final frames, Other Directories and Libraries options can now be unchecked when using theExport to Offline option in Control Center, reducing the size of scenes when exporting inoffline format.
Options to export libraries can now be hidden from the WebCC interface. This can preventthe accidental export of libraries from the Environment or Job levels and unnecessary
increases of file size of exported offline scenes.
These options can be hidden by adding the “-hideLibExport” option to the WebCC service
launcher.

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

GenerallHarmony crashes on Big Sur when there is a texture in the colour palette. HAR-6759

lMorphing hints don’t display properly anymore. HAR-6430lService Launcher's default path is wrong on macOS Catalina. HAR-5663

lTemporary files created in the ToonBoomSessionTempDir, when importing PSD files or using a script, are notdeleted if a Wacom driver is installed on Windows. HAR-6539

lPressing the spacebar does not reset the Transform tool manipulator. HAR-6858

lTransform tool manipulator does not follow properly when rotating the Camera view. HAR-6859

lSelecting multiple drawings with the Transform tool changes the active pivot. HAR-6596

l

The Reset Current Keyframe command in the Deformation toolbar doesn't reset the rotation on Free FormDeformer points. HAR-5928

l

The Kinematic output does not work properly when a Static Transformation node is used with a deformation chain
set to Default Transformation. HAR-6293

lSelecting a 3D model with the Transform tool does not work when another layer is locked. HAR-6659

8

Toon Boom Harmony 20.0.6 Release Notesl

The second controller of a Two Points Constraint node cannot be selected when there is a Transformation Gate
node under it. HAR-6770

lScene with corrupted bezier curves causes Harmony to crash when opening. HAR-6836

l

The Camera view becomes unresponsive if a peg with a scale of 0 is above a weighted deformer. HAR-6647

l

The Pose Copier does not remember the Fill to Next Key Exposure state. HAR-6701

Drawing Toolsl

Delay drawing with the Brush tool when using a mouse or a drawing tablet that has a high polling rate on macOS.
HAR-6749lStraight line changes to a curve when lines are connected using Line Building Mode. HAR-6263

lThere’s a delay when drawing using a textured pencil in a scene in Database mode. HAR-6654

lTools presets don’t work with bitmap layers. HAR-5788

lRandom crashes when drawing straight lines with the Pencil tool by pressing SHIFT. HAR-6726

TimelinelDragging keyframes on a Colour Curve, Colour Levels or Subnode Animation layer extends the select to layers
below. HAR-6225

l

Audio scrubbing offsets and plays audio from the wrong frames. HAR-6721

Node ViewlEntering or exiting a group using cable navigation does not work anymore. HAR-6352

Master Controllersl

MC Function Wizard: Invert Slider option does not work. HAR-6080

lKeyframes that have identical values are not added to the tbState when creating a master controller. HAR-6551

lPoor performance when scrubbing the Timeline while Deformers on Deformer is displayed in the Camera view.
HAR-6187l

Reset Current Keyframes does not always properly reset the position of a Deformer on Deformer curve. HAR-6217

l

The curve to manipulate a Deformer on Deformer does not always follow properly. HAR-6722

lOnly the min and max values work properly when creating a SliderWidget from a Transformation Gate using the
Function Wizard. HAR-6673

9

Toon Boom Harmony 20.0.6 Release Notes

Export and RenderinglRendering frames in batch reports sound engine errors when launched from a service, causing deadline to report
errors even when the render is good. HAR-6667

lExporting OpenGL frames using the openH264 codec does not work. HAR-5544l

The selected format in the Export Movie dialog switches to QuickTime when clicking the browse button. HAR5802

l

The Use Source/Matter Colour option does not work with effect nodes that have the blur type set to Directional.
HAR-6484

ImportinglHarmony fails to import video files that don’t have audio or if their resolution does not match the scene resolution
in Windows. HAR-6543

l

No error messages when importing an unsupported video file on Windows. HAR-5909

lImporting an interlaced 16-bit per channel PNG does not work. HAR-6716

l

Crash when importing Alembic files with out of bound colour values. HAR-6844

lSome WMV files import with missing frames onWindows. HAR-6805

DatabaselDrawings can be lost when using the Update Database Scene command if elements were renamed or duplicatedoffline. HAR-6586

l

The dbserver will attempt to close the table twice when upgrading a table to a new format. HAR-6718

l

The Force Unlock Scene command in Control Center doesn't release all the locks. HAR-6688

lJobs remain in the In Production list after moving them to completed. HAR-6408lAuto flatten does not work with the Brush tool if the Pencil tool has Line Building Mode enabled. HAR-6717

lThumbnails are not rendered in library folders located on a database if Harmony is running on Windows and uses
a shortcuts.conf file to connect to the server. HAR-6809

lScene is locked for editing when a preview render is generated for WebCC. HAR-6773

l

The Queue application randomly freezes and does not update job statuses properly. HAR-6684

ScriptinglPalette::setTextureFile does not flag palette as modified. HAR-6727

l

The Pose Copier Paste button has to be clicked multiple times to work with some template. HAR-6672

lPasting an action template that does not contain groups does not work when using
copyPaste.pasteActionTemplateIntoNode. HAR-6652

10

Toon Boom Harmony 20.0.6 Release Notes

Toon Boom Harmony 20.0.2
Here is the list of changes in Harmony 20.0.2, build 20.0.2 16529 (2020-11-26):
NOTE
Harmony does not natively support the new Apple M1 chip. On systems using the new Apple M1 chip,
Harmony runs through Apple’s Rosetta 2. This may cause compatibility issues when running on the new
ARM-based macOS systems.

Fixed Issues:lCrash on macOS Big Sur when selecting the Tool Properties tab while the Brush, Pencil or Eraser tool is active.

l

The Force Unlock command in Control Center doesn't release all the scene locks.

l

The Drawing Selector list in Harmony Scan can have duplicate or missing entries.

Known Issues:lIssue: On macOS Big Sur, Harmony crashes on some systems if there is a texture in the colour palette while theinterface is in Light Style.
Workaround: Enable the Use Dark StyleSheet preference located on the General tab to prevent the crash.

lIssue: On macOS the path set by default in the Service Launcher's Service location field uses the translocated path.
Workaround: Manually set the path to the application’s bin folder. e.g. /Applications/Toon Boom Harmony 20
Premium/Harmony Premium.app/Contents/tba/macosx/binlIssue: Entering or exiting a group in the node view using the Enter key while navigating the node graph with the
keyboard does not work anymore. It opens the Find and Insert Node menu instead.
Workaround: Shift+Click the group or click the arrow on the right to go inside the group.

11

Toon Boom Harmony 20.0.6 Release Notes

Toon Boom Harmony 20.0.1
Here is the list of changes in Harmony 20.0.1, build 16044 (2020-06-29):

Fixed Issues:lCrash when launching Harmony on a macOS computer with a CPU that does not support Advanced Vector
Extensions (AVX).

l

Crash when using the Tab key in the qsdb> field of the Qt Script Debugger to get auto-complete suggestions.

12Toon Boom Harmony 20.0.6 Release Notes

Toon Boom Harmony 20.0.0
Here is the list of changes in Harmony 20.0.0, build 15996 (2020-06-11):
IMPORTANT
Important enhancements have been done to the Harmony Server database. As such, in order for Harmony 20
clients to function properly, the database server must be updated to Harmony 20.
Furthermore, the dictionary files (.dict) in the database must be updated with the ones included in the
Harmony 20 packaging. To do this, copy the files from the following location:
Windows: C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony 20 [Edition]\etc\USADB_ltemplates\dicts
macOS: /Applications/Toon Boom Harmony 20 [Edition]/Harmony [Edition].app/Contents/tba/etc/USADB_ltemplates/dicts
GNU/Linux: /usr/local/ToonBoomAnimation/harmony[Edition]_20/etc/USADB_templates/dictsl

And paste them in the following location in your database, replacing the existing files:/USA_DB/dicts
Note that a database server running Harmony 20 is backward compatible with clients running older versionsof Harmony.

ll

New Features on page 13lDrawing Tools on page 13lAnimation on page 15lEffects and Compositing on page 17lDatabase / Control Center on page 20lWorkflow Improvements on page 21lMaster Controllers on page 22lScripting on page 23lRendering and Pipeline Integration on page 23

Fixed Issues on page 24

New Features
Drawing Tools
FeatureDescription

Editions

Centerline Editor Tool

Improvements have been added for editing brush lines with the

All

13

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

Centerline Editor tool:limprovementslConvert Textured Pencil to
Brush

Points can now be deleted from the center line curve onbrush strokes by selecting them and pressing the Delete key.
New Centerline Smoothness option to control the fitting of
the center line is now available in the Tool Properties view.

It is now possible to convert textured pencil lines into textured brushstrokes when using the Convert Pencil to Brush option in the Selecttool properties.

Advanced &Premium

New options in the Line tool properties to curve the line on mouseup:lOptions to curve Line toollCurve Line Mode allows to draw a curved line by moving themouse after drawing a straight line. Click or press Enter tocommit the curved line.

All

S Curve Line Mode allows to draw a S-shaped curved line.
Moving the mouse after creating a straight line will curve theline from both ends until the mouse is clicked. The tail end of
the line will then curve until the mouse is clicked again orEnter is pressed.

l

Select tool improvementslPreserve the position of the Select tool pivot when using
Undo and Redo commands.
The Select tool pivot now follows the selection when scaling,rotating and skewing.

All

Auto Fill with Brush

New Auto Fill option in the Brush tool. When active, drawing aclosed shape with the brush tool will automatically fill it with thecolour assigned as the current paint colour.

All

Button for the Repaint Brushtool

A button for the Repaint Brush tool is now available in the Tools
toolbar.

All

Alignment Guides with drawing
tools

The Alignment Guides can now be used with the drawing tools.

All

Pencil Texture Eyedropper tool

A new Pencil Texture Eyedropper tool is now available. Clicking apencil line drawn with a texture using this tool will select the texture
in the Pencil Texture Palette list.

Advanced &Premium

14

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

Select Strokes with Current
Pencil Texture

A new command has been added to select strokes that use thecurrently selected pencil texture. The command is called SelectStrokes with Current Pencil Texture and is available in the Edit menuof the Camera and Drawing views.

Advanced &Premium

Line Building Mode
improvements

The Pencil tool’s Line Building mode does not trim lines anymore
when drawing perpendicular lines away from the tips.

Advanced &Premium

Preserve selection when
undoing or redoing

The Contour Editor, Perspective and Envelope tools now preserve
the selection when using Undo and Redo commands.

All

Snap only to selected layers

A new option called Allow Snapping on all Drawings Layers is now
available in the snapping options for drawing tools. When enabled,
snapping will work as it did in previous versions and the selection
will snap to all visible drawing layers when working in the Camera
view. When disabled, snapping will only occur with drawings thatare on the selected layers.

All

Independent quality for
Perspective tool

The quality of the transformation when using the Perspective tool
Lattice mode is not affected by the smooth value set in the EnvelopeAlltool anymore.

Independent smoothness for
Smooth Editor tool

The smooth values for the Envelope tool and the Smooth Editor are
now independent.

All

Adjust Eraser size with hotkey

You can now adjust the eraser size with the “O” keyboard shortcut
while using the eraser end of the tablet pen.

All

FeatureDescription

Editions

Undoable selections

New preference called Undoable Selection. When this preference isenabled, selection changes such as selecting drawings with thetransform tool or changing the selection in the Node view adds
entries in the undo list. You will find this preference on the Generaltab of the preferences and is enabled by default.

All

Transform tool drags fromanywhere

New Easy Drag option in the Transform tool properties. Whenenabled, the selected objects can be moved by clicking anywhere inAll

Animation

15

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

the transform tool selection box.
New commands and buttons to quickly set ease in and ease out of
keyframes selected in the Timeline. The commands are:ll

Quick Ease In/Out for keyframes

l

l

l

l

l

l

l

l

Drawing Substitution view
improvementslNode Caching improvement

Quick Ease In: Sets the ease on the left side of the selected
keyframe to 33%.

l

Scene Markers improvements

Quick Ease: Sets the ease on both sides of the selected
keyframe to 33%.
All

Quick Ease Out: Sets the ease on the right side of theselected keyframe to 33%.
Set Ease on Selected Keyframes: Opens a dialog box where
different values of ease can be set on either side of theselected keyframes.
Scene markers can now be created without a duration.
The Mark Current Frame command creates markers without
opening a dialog box. This allows creating markers during
playback by setting a shortcut to this command.
Scene markers can be selected and moved by clicking onthem with the mouse.
Double-clicking a scene maker opens the Marker editor.
The Create Scene Marker command does not require toselect frames in the Timeline ruler anymore. A marker withno duration can be added without making a selection. A
marker with duration can be added by making a selection in
the frames section of the Timeline before using thecommand. In both cases, the Marker Creation dialog box
opens to allow setting all the attributes of the maker as it iscreated.

All

New option to ripple scene markers when inserting or
removing frames in a scene.
It is now possible to rename and delete drawings in the
Drawing Substitution view when in Edit Mode.

All

A search filter has been added.

When doing a lasso selection over multiple characters in Node
Caching mode, only the currently off cache parts will be selectable.

16

Premium onlyToon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

In previous versions any other character touched by the lasso would
go off cache. You can Shift select multiple characters if you want to
put more than one characters off cache.

Effects and Compositing
FeatureDescription

Editions

New Surface Shading nodes provide the ability to perform moreadvanced lighting effects on 2D objects or characters. The nodes are:l

Ambient OcclusionlCast ShadowlShape Curvel

Shape Linel

Shape RenderlSurface MaplSurface RenderlSurface Normal

New Surface Shading effects

Premium only17

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

A new deformation effect, the Weighted Deform node, provides away to deform with high quality blending, multiple deformation
regions. It is especially good with textures. Different deformation
sources can be used: Envelope, Pegs, Curves, Bones andConstraints.
New Weighted Deformation
effectPremium only

A new deformation effect, the Point Kinematic Output node,
provides a way to attach a drawing anywhere on a deformer insteadof just at the end of it like the existing Kinematic Output node does.
Multiple sampling options are available:l

One-Point Sampling: Tracks position only.

New Point Kinematic Output
effectPremium only

l

l

l

Two-Point Sampling: Tracks position and rotation.
Two-Point Sampling with Scaling: Tracks position, rotationand scaling.
Three-Point Sampling: Tracks position, rotation, scaling andskewing.

18

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

New Pre-Render caching

A new optimization node, the Pre-render Cache node, provides away to lighten and speed-up the rendering of complex scenes. You
can think of it as a simplified Composite node used to store a cacheof rendered frames for selected nodes.

Premium only

The new colour correction effect, Colour-Fade node, allows thecolour values to fade over time from the input colours to newcolours. It can:New Colour-Fade effectlFade from the input palette to a clone of this palette.

l

Fade the colour values of a single pot to other values.

lFade according to different colour models, RGB, HSV or HSL.

l

Be set to render only a selection of colours pots.

Premium only

The new colour correction effect, Colour Curves node, provides aquick way to adjust colours and contrast of RGBA channels.
l

New Colour Curves effect

The node uses a graph editor to shape curves of thesechannels.

lAllows to control each channel independently.

lAllows to control the input and output range of values.

Premium only

New Colour Levels effect

The new colour correction effect, Colour Levels node, provides aquick way to adjust the colour balance and contrast of an image byallowing to manipulate the white point, black point and midpoint of
the RGBA channels. It offers an easy way to adjust those parameters
over time in the Timeline.

Premium only

New Gamma effect

The new colour correction effect, Gamma node, provides controls forthe gamma value for each channel independently or globally.

Premium only

19

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

Particles can extend past 12
field area

A new Vector Drawing option has been added to the Shape Type listin the Planar-Region particle node, allowing particles to extend past
the 12 field chart area.

Premium only

Description

Editions

Database / Control CenterFeatureImprovements have been added for copying scenes in Control
Center:l

Copy scenes improvementsllSave As command in whenusing a database

You do not have to create an empty scene beforehand as
before.
Copy multiple scenes at the same time

Advanced &Premium

Options to add prefix and suffix or replace parts of the namesof copied scenes.

A new Save As command in the Harmony application allows you tosave a scene to a new location without having to use the Control
Center application.

Advanced &Premium

Execute scripts on multiple
scenesA new command in the Control Center called Run Script can be used
to execute a script on a selection of scenes.

Advanced &Premium

Import multiple offline scenes

New command called Import Multiple Scenes in the Admin menu
can be used to import multiple offline scenes.

Advanced &PremiumCreate scenes in any location

You can now create a scene in any location. When using a Harmony
database in previous versions, scenes could only be created infilesystems that were part of the database. You can now customize
the path used as the scene folder or create multiple scenes in acommun parent folder.

Advanced &Premium

Release unused tables

The Harmony database server (tbdbserver) now monitors open
tables and closes tables that have been left open by clients. This
prevents issues where the database server becomes unresponsive
after a long period of use.

Advanced &Premium

Better handling of dropped TCP
connections

Better handling of dropped TCP connections caused by network
infrastructure. When a TCP connection is dropped, the database

Advanced &Premium

20

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescription

Editions

server will now be able to recover the connection and its associatedlock.
The render queue refresh has been optimized to refresh faster. Thisrequires copying the new comp_log.dict file to the dicts folder ofthe database when upgrading to Harmony 20.

Advanced &Premium

FeatureDescription

Editions

Snapshot buttons

New buttons in the Camera status bar to take and review asnapshot. You can use the Take Snapshot command to store atemporary copy of the content of the Camera view and later press
the View Snapshot button to compare it to the new modified state.

Advanced &Premium

Find and Insert Node

The Node view now has a new menu to find and insert a node. You
just have to press Enter to open the menu and type to search for thenode to insert.

Premium only

Eyedropper in Colour Overrides

The Colour-Override node now has eyedroppers to select a colour ora pencil texture from the Camera or Drawing view.

All

Quick connections of nodes

In the Node view, connections can be created between nodes byselecting a node then clicking the target node while holding the ALT
key. This will create a connection from the bottom of the first node to
the top of the target node. Connections can be created from the top
to the bottom of a target node by holding ALT+SHIFT before
clicking the target nodePremium only

Cable Cutter mode

A new mode is now available in the Node view to cut cables bydragging the mouse over them. The Cable Cutter mode can be
enabled using a button in the Node view toolbar or by setting anoverride in the Shortcuts.

Premium only

Displays in alphabetical order

Displays are now listed in alphabetical order in the display list.

Premium only

Type to filter lists

You can now type to filter different lists to make it faster to findsomething. Available in the:All

Queue viewer optimization

Workflow Improvements

21

Toon Boom Harmony 20.0.6 Release Notes

FeatureShortcuts in tooltips

Description

Editionsl

Font list that appears in the Text Tool propertieslDestination Layer list in Lip-Sync MappinglSynched drawing layer listlButtons and scripts lists when customizing a toolbarlDisplays list of the Display toolbars

Shortcuts assigned to commands and tools are now displayed in thetooltips that appear when the mouse hovers on icons.

All

Description

Editions

Master Controllers
FeatureThe new master controller creation wizard can be used to create acurved deformer over an envelope deformer. This wizard is available
in the Master Controller toolbar and is called Create Deformer on
Deformer.

Deformer on deformer wizard

Premium only

Function Wizard

The new master controller creation wizard can be used to create acontrol that manipulates any attribute from the selected nodes. Thiswizard is available in the Master Controller toolbar and is called
Function Wizard.

Premium only

Slider Wizard

The master controller Slider Wizard now remembers that settings
used to create the previous master controller.

Premium only

Grid Wizard

The Master Controller Grid controls can now be moved by clicking
and dragging the box that appears around the 2D widget control in
the camera view.

Premium only22

Toon Boom Harmony 20.0.6 Release Notes

ScriptingFeatureDescription

Editions

Support for Python

We now support the creation of Python objects in our JavaScript
environment using a module named PythonManager. This module isused to manage the Python interpreter and to create a Python
object. Using that newly created python object, it's possible to callsome python functions.

All

The documentation for the Python object as well as some otheradvanced scripting modules can be found using the Help > Extended
Scripting Interface Documentation command.

Method to list the name ofviews

Added the new view.viewList() function which returns all of thecurrent views in Harmony. It can alternatively be called with aparameter, a type of view, to only return the views of that type.

All

Rendering and Pipeline Integration
FeatureDescription

Editions

Render QuickTime movies in
16-bit on macOS

Rendering to QuickTime on macOS now supports bit depth up to 16bit.

All

Write node can process movie
with scripts

The Write node can now be configured to run a script whenrendering. This can be used to compress movies using external tools
such as ffmpeg. To set a script in the Write node, select Scripted
Movie in the movie drop list. See the WriteNode class in the scripting
documentation for examples of scripts.

Premium only

Importing media through MediaFoundation

Importing audio and movie files on Windows is now done throughMicrosoft Media Foundation. Only audio and video files that are in aformat supported by Microsoft’s Media Foundation can be imported
in Harmony.

All

Harmony now supports colour management for imported images,
internal processing, displaying in the camera view and for final
output.
Colour space managementll

A scenes colour space can be defined in the Scene > Scene
Settings dialog box.
The colour space used to read an image can be defined in the
Element node properties at the bottom of the Drawing tab.

23

Advanced &Premium

Toon Boom Harmony 20.0.6 Release Notes

FeatureDescriptionlEditions

Exported movies and images can be tagged in the write nodeor from their export dialog box.

The list of codecs available depends on the version of macOS that isused but the following are now available on Catalina:
Support for additional
QuickTime codecs on macOSlApple ProRes 422 HQlApple ProRes 422 LT

lApple ProRes 422 Proxyl

H.265. Alpha channel support is available with Catalina.

All

Fixed Issues
The following issues have been fixed in this release:l

Drawing and Drawing Tools on page 24lTimeline on page 25lEffects on page 25lNodes and Node View on page 25lMaster Controller on page 25lImport PSD on page 26l

I/O on page 26l

WebCC on page 26lPerformance on page 26lOthers on page 26

Drawing and Drawing Toolsl

In the Camera view, the application hangs while drawing if very small scaling values are set in the layer's
parameters.

l

In some situations when you have multiple layers selected the Cutter tool bounding box can be infinite.

l

When using the Line, Rectangle or Ellipse tools with Snap to Contour or Snap and Align, the snap cursor circle isoffset if you zoom in or out.

l

The Smooth Editor tool uses the Brush tool size properties instead of its own.

24Toon Boom Harmony 20.0.6 Release Notesl

The TB_RecolorDrawings script does not work with color palettes if the palettes were created while importing animage with the color_vectorize option.

l

The Create Breaking Triangles command on lines thinner than 4.5 doesn't work properly.

l

The Lattice mode in the Perspective tool is using the smoothing value from the Envelope tool.

l

The start of a straight line becomes curved when using Line Building mode.

l

The Line Building mode trims lines when connecting far from existing tips.

lCenterline Editor tool generates too many points on its centerline.

TimelinelClicking the last frame of a scene in the Timeline ruler cuts the scene duration by 1 frame.

lCannot drag multiple point keyframes from Free Form Deformation and Subnode Animation in the Timeline.

lExtending an exposure with the red arrow in the Xsheet view removes the exposure for the next drawing insteadof just changing the section that you overlap.

Effectsl

Particles emit outside the area of the image when the image is used as the source in the Planar-Region node.

lParticles appear behind the source image instead of over it when Planar-Region node is set to Shape Type: Imageor Vector Drawing.

lWhen editing a Free Form Deformation trajectory, the preview of the trajectory is wrong when manipulating apoint.

l

On macOS we can't customize the Deformation toolbar after drawing/painting or other actions.

l

The compositing order changes when drawing with semi transparent colour and there is a 3D model in the scene.

Nodes and Node Viewl

Alt key doesn't work when connecting or disconnecting some nodes in Node View.

l

The Ignore Parents and Parent's Name options in Transformation Limit nodes are ignored if there is aTransformation Switch node between the deformation system and the Drawing node.

Master Controllerl

Master Controller controls don't show the correct position when first displayed.

l

The Slider Wizard window opens even if there is no node/layer selected.

lRearranging and adding spaces between poses with the Unroll Wizard doesn't work if poses aren't sorted bydestination frame.

lDifferent grid layer configurations can break the MC Stack Wizard.

25

Toon Boom Harmony 20.0.6 Release Notes

Import PSDlCannot import PSD image as Toon Boom Bitmap or Toon Boom Vector Drawing using the Individual Layers option.

lImporting PSD layers as Individual Layers isn't working correctly when layers are using special characters like #, /
or -.

I/O
l

Harmony does not allow importing TIFF images with the .tiff extension.

l

QuickTime import doesn't work in batch mode through scripting.

lNo error is printed when running a script on the command line in batch mode fails.

lCrash exporting movie through JavaScript in scene with a ScriptModule node.

l

The -renderThread option is not taken into account when doing command line render.

lHarmony offline sometimes does not open the 7z files created by WebCC.

l

Cannot import offline scenes to the database with Control Center on command line where the number of element
ID in the scene exceeds 9999. The error code given is also wrong.

WebCC
l

WebCC doesn't work with new versions of Firefox, Microsoft Edge and Chrome.

l

The timestamp on the temp folder created when exporting uses minutes as the smallest unit.

lCannot export an empty scene from WebCC. This happens when creating a scene in WebCC and then trying toexport it right away.

lWhen using the Update Database Scene command, a “ping successful” message wrongly appears when theserver takes too long to respond.

PerformancelPerformance is very slow when doing a lasso selection of multiple elements with the Transform tool and thenmoving those parts in the OpenGL view.

lPerformance issue when rotating a specific peg made with function curves shared with other nodes.

OtherslSpecifying a port when borrowing a license using the License Wizard does not work.

l

On macOS, the "More Tools" in the Harmony application menu leads to the tba folder instead of Applications
folder.

l

On macOS 10.14 and 10.15, Harmony freezes when editing the element name from the layer properties and then
immediately after pressing the Close button. HAR-5901

l

Two users can make changes to the same drawings when opening a scene using local cache.

26

Toon Boom Harmony 20.0.6 Release Notesl

Crash when importing a bitmap image into an existing layer that contains a 3D object.

lBatch render crashes when a scene contains Transformation Limit and Transformation Gate nodes.

lCan not download the OpenH264 codec with the Configuration Assistant on macOS 10.14 and 10.15.

27