Toon Boom
Harmony22
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 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 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-11-2023
Copyright © 2023 Toon Boom Animation Inc., a Corus Entertainment Inc. company. All rights reserved.

1

Toon Boom Harmony 22.0.3 Release Notes

Table of Contents
Table of Contents

2

Harmony 22.0.3 Release Notes

3

Harmony 22.0.2 Release Notes

5

Harmony 22.0.1 Release Notes

11

Harmony 22 Release Notes

152

Toon Boom Harmony 22.0.3 Release Notes

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

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

Generall

Copy-pasting keyframes from the Timeline may paste the wrong value when ease functions are used. HAR-9374

lRepeatedly using the Previous Drawing [F] or Next Drawing [G] shortcuts may skip frames on Windows and Linux.
HAR-9411l

Pressing and holding the Previous Frame [,] or Next Frame [.] shortcuts skips frames on Linux. HAR-9410

lHarmony may be unable to read drawings created over 10 years ago. HAR-9358

lTyping Korean double consonant characters does not work on Windows and Linux. HAR-9080

Timelinel

Frame Markers disappear when dragging and dropping frames in the Timeline. HAR-9448

DrawinglHarmony may crash when using the Create Colour Art from Line Art command on drawings that have invalid
triangles. HAR-9461

Cameral

The wrong colour is picked when using the Colour Picker view dropper to pick a colour from the screen, if multiple
screens are connected and using a scaling factor other than 100%. HAR-9198

Effects and CompositinglHighlight and Tone effects don’t render properly when Use Matte Colour and Invert Matte options are enabled.
HAR-9277lParticles have the wrong size when the scene’s FOV is not set to vertical. HAR-9325

lHarmony may crash when rendering gaussian blurs if the Repeat Edge Pixels attribute is enabled. HAR-9304

lRadio buttons in the Write node Enabling tab all have the same label. HAR-9383

ScriptinglDrawingTools.modifyStrokes from the extended scripting interface cannot be used to change the thickness of a
pencil stroke. HAR-9269

3

Toon Boom Harmony 22.0.3 Release Notes

Import / Exportl

There is no audio in exported movies when Harmony is in Spanish. HAR-9360

lHarmony may run out of memory when rendering if there's an Animate Pencil Texture effect node in a scene thathas over 1200 frames. HAR-9363

lAnimate Pencil Texture effect is randomly not applied when there are two drawing nodes or more. HAR-9364l

The last exposed drawing is rendered on empty frames when exporting using the File > Export > OpenGL Frames…
command. HAR-9121

WebCC
l

A scene exported before upgrading to 22.0.2 cannot be imported using WebCC after updating the database with
the new export.dict file. HAR-9367

Control Centerl

Palettes are imported when unchecking the Palettes options if Scene and Backup are not unchecked as well. HAR5105

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

lWhen using Harmony on macOS Big Sur, Harmony may crash when saving a colour in macOS’s native colour
picker. HAR-8032

lDatabase scenes that have a custom path cannot be copied using Control Center. HAR-6386

lStroke remains in place after removing the last point of a branch with the centreline editor. HAR-5994

lWhen using an iPad Pro in Sidecar mode with Harmony, every second click registers as a double-click. HAR-8801

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

lOn macOS Mojave, GateKeeper prevents launching Harmony unless the quarantine extended attribute is removed
from the application bundle. HAR-7775

The quarantine extended attribute can be removed using the following command in the Terminal:
sudo xattr -dr com.apple.quarantine "/Applications/Toon Boom Harmony 22 Premium"4

Toon Boom Harmony 22.0.3 Release Notes

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

Improvements
Utilitiesl

The utransform utility now has the ability to print and clear metadata from a TVG using the -print_meta_data and clear_meta_data options. HAR-8421

Scriptingl

Scene version description can now be queried and set using scene.Description and scene.setDescription from theHarmony scripting interface. The description can also be set when importing a scene through Control Center using
ImportData.impDescription. The description text is limited to 200 UTF-8 characters. HAR-8792l

The scene.closeSceneAndOpen JavaScript function has a new isReadOnly parameter which allows opening ascene in read-only mode. For example using scene.closeSceneAndOpen( "Env", "Job", "Scene01", "1", true); willclose the current scene and open Scene01 in read-only mode. This can only be used when a scene is opened inHarmony from the database. HAR-9042

lAdded SceneOffline.createDatabasePartialUpdatePackage scripting function to create partial update packages for
uploading to WebCC. HAR-8875l

The TB_MayaBatchRenderModule.js script has been modified to support renders using the 3Delight render plugin
for Maya. HAR-9148

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

Cameral

Small changes in the camera’s FOV don't have any effect and cause stutter when animating the FOV. HAR-9005l

The Tab key shortcut to move the transform tool pivot does not work. HAR-8868

Drawing Workflow and ToolslHarmony crashes when closing a shape drawn with a textured pencil by holding the Ctrl key (command key on
macOS) while Mirror View is enabled. HAR-9011

lDrawing with the Ellipse or Rectangle tool with snapping may draw on the wrong drawing layer. HAR-8985lHarmony may crash when rotating a drawing using Ctrl+7 (command+7 on macOS) while the select tool is active.
HAR-9118lRare crash when using the Stroke tool. HAR-9123

5

Toon Boom Harmony 22.0.3 Release Notesl

Random crashes in the Pencil Editor tool. HAR-9126

l

The Contour Editor creates loops when snapping adjacent vertices. HAR-9131

lLines on unselected layers are difficult to see when the Light Table is enabled and the working colour space is set
to Linear. HAR-7446

lPasting a cut drawing object doesn't paste it at the proper location if there is an offset on the source or target
drawing layer. HAR-8854, HAR-9168

l[Windows] Drawing Desk thumbnails display in low resolution on HiDPI monitors. HAR-8885l

The Drawing view sometimes doesn't refresh when changing the selected drawing in the Drawing view Desk
using the F and G shortcuts. HAR-9073

l

The preference ‘Light Table: Shade in Camera View’ setting is not being saved. HAR-9075

lDrawings in the Reference View don't update when colours are changed using the Colour Picker. HAR-9076

l[Linux] The Colour Picker’s eyedropper tool always picks RGB values 0, 48, 57. HAR-8778

lZoom and rotate keyboard shortcuts can be used while drawing. HAR-9077

lShortcut to change to the Select tool does not work in the Reference View. HAR-9094

l

The Drawing View Magnifier does not work properly. HAR-9018

lDeleting a drawing in the Drawing Substitution view which is also linked in a timing column in the Xsheet may
cause a crash. HAR-9224

lEnabling Adjust Pencil Line Thickness in the drawing Layer Properties may cause artifacts on the pencil lines whenrendering. HAR-9250

lIncreasing the width and height divisions in the Envelope tool can cause a crash. HAR-9264

lElements and drawings are duplicated when cutting and pasting element nodes in the Node View. HAR-9078

Function EditorlSelecting multiple points on a 3D path in the Function editor with the marquee selection tool doesn't work. HAR9103

l

The Function editor commits a random value to the selected keyframe when the Value field is empty and loses
focus. HAR-8830

GenerallUndoing after linking and reordering palettes may cause a crash. HAR-7725

lDuplicated drawings may be lost when saving a scene if synced layers have the same base name. HAR-8887

lCopying multiple synced layers from one instance of a character to another may cause new drawings to go
missing. HAR-8899

6

Toon Boom Harmony 22.0.3 Release Notesl

The Transform tool bounding box is at the wrong position when using bitmap drawings with weighted or freeform
deformers. HAR-7787

lHarmony freezes when trying to read a TVG that has metadata. HAR-8409

Import / Exportl

PSD files saved in Photoshop with compatibility mode disabled don't import correctly when imported using theSingle Layer option. HAR-8849

lWhen importing a PSD layout image along with its XLI file, the XLI file from a previously imported image is used.
HAR-9175lHarmony crashes when rendering to SGI 8-bit greyscale images. HAR-9010

lRenaming a palette does not flag the palette list as modified, causing the palette not to be saved. HAR-9179

l

The Multi Layer Write node may cause adjacent drawing substitutions to composite in the same frame whenexporting using Render Write Nodes. HAR-8228

Nodes and Compositingl

OGL-Controller node soft renders drawing from cable that is connected to the Controller Position port. HAR-8877

l

The Deformation Composite node blocks transformation from upstream pegs. HAR-9034

lHarmony crashes when the OGL Controller has a label and the scale of the connected peg is set to 0. HAR-9102

l

The Matte-Resize node can cause rendering to fail. HAR-9163

l

The Blur effect on drawings connected to a Highlight or Tone node doesn't render correctly when intersecting withthe camera edge if the Invert Matte option is enabled.. HAR-9181

l

The Auto-Patch node may cause a crash when rendering and changing frames if thumbnails are displayed in the
Node View. HAR-9255

PerformancelDrag & drop of frames in the Timeline can be slow with some scenes. HAR-8726

lOperations that involve changing the current frame become slower with more Master Controller controls visible.
HAR-8747

Rendering and Pipeline IntegrationlHarmony may crash with a memory corruption while rendering a scene in batch if a large number of rendering
threads are used. HAR-7875

lSmall or simple drawings are sometimes missing from rendered frames when rendering using multiple threads onfast processors. HAR-9012

7

Toon Boom Harmony 22.0.3 Release NoteslAlpha channel from movies rendered using ProRes 4444 or 4444 XQ is detected as straight by third party
softwares. HAR-7363

l[Windows] Rendering to ProRes in Windows rounds down the horizontal resolution to the nearest multiple of 16
pixels, cropping the rendered images. HAR-9001

l

Exporting to SGI in 16 bits causes crash or colour corruption. HAR-9008lHarmony may crash when batch rendering if palettes are located outside of the scene. HAR-9023

lIncorrect colours when the scene processing depth is 32-bit and the export format is set to 8-bit. HAR-9047

lHarmony may crash when displaying 3D models in the Perspective view if the OpenGL preference “Enable
composite passthrough for all effects” is enabled. HAR-9082

l

The Hold-Timing node causes OpenGL refresh issues and a possible crash. HAR-9161

lSelecting using the Shift key does not work well when scrolling the list of jobs in the Render Queue. HAR-9117

lMovies exported using 23.976 frame rate have their frame rate expressed as 2997/125 instead of 24000/1001.
HAR-9109lWhen overwriting an existing movie file fails because it is opened or locked while batch rendering, Harmony will
write the movie with a unique name using the date and time. HAR-9133

Scriptingl

addNodeToSelectionNode, addNodesToSelectionNode and removeNodeFromSelection in the selection class do
not work with backdrops correctly. HAR-8391

lPython's multiprocessing library is misconfigured when running on Windows. HAR-8567

l

TB_RecolorDrawing.js will not work if a selected drawing node has no element ID. HAR-9062

Timeline and PlaybacklPlayback pauses momentarily at the end when Loop and Sound options are enabled. HAR-8988

l

The F keyboard shortcut for 'Go to Previous Drawing' skips key exposures. HAR-9019

lWhen the 'Snap Keyframe' preference is enabled, copying and pasting a keyframe in the Timeline may cause acrash. HAR-9199

UI
l

It's not possible to use the backspace key to remove the last digit in some fields such as those in the "Render Write
Node" dialog. HAR-9009

lTyping decimal values in numerical input fields does not work when the OS is set to French. HAR-9016

l[Windows] Play does not work when there's a collapsed Camera view in the workspace. HAR-9141

8

Toon Boom Harmony 22.0.3 Release Notesl[Windows] Uncollapsing a hidden camera view may cause a crash if a HiDPI monitor has scaling enabled. HAR9142

l[Linux] Focus On Mouse Enter doesn’t always work. HAR-9095

l

Korean characters are not being typed in correctly. HAR-9080lHarmony freezes if the Audo-save warning appears while doing a drag and drop operation. HAR-9235

Database / Control Centerl

Copying a scene in Control Center does not work if the scene is not selected once the copy scene dialog opens.
HAR-7888l[WebCC] Toast messages no longer appear once imports and exports are completed. HAR-8884

l

WebCC stops responding to database requests if inactive for 48 hours. HAR-9114

lBaking of many scenes in WebCC results in error [Error: EMFILE: too many open files...]. HAR-9122

lControl Center doesn't save the ‘Get rights to modify all assets' setting for environments. HAR-9074

lWhen 'Update Database Scene' fails the error reporting is uninformative and sometimes wrong. HAR-8843

lLocks can be taken on the root folder, preventing locks to any other folders in the database. HAR-8556

lRendering through Control Center's scripting interface does not use the scene’s default camera if it is not specified
by name. HAR-8403

l[Windows] WebCC does not start on a new Windows installation due to missing MSVCR120.dll in path. HAR8873

lUsing the ’‘Update Database Scene” command can corrupt the scene in the database if the scene was changed
since it was exported offline. To address this issue, a new dictionary file named export.dict has been added toHarmony 21.0.4. The export.dict file will have to be manually copied to the /USA_DB/dicts/ folder in existing
Harmony databases. New databases created using Harmony 21.0.4 have the new dictionary file. HAR-8858

XsheetlWhen the keyboard is set to french, pressing the ^ key in the Xsheet crashes Harmony. HAR-9006lRare and random crashes in Xsheet UI. HAR-9125

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

lWhen using Harmony on macOS Big Sur, Harmony may crash when saving a colour in macOS’s native colour
picker. HAR-8032

lDatabase scenes that have a custom path cannot be copied using Control Center. HAR-6386

9Toon Boom Harmony 22.0.3 Release NoteslStroke remains in place after removing the last point of a branch with the centreline editor. HAR-5994

lWhen using an iPad Pro in Sidecar mode with Harmony, every second click registers as a double-click. HAR-8801

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

lOn macOS Mojave, GateKeeper prevents launching Harmony unless the quarantine extended attribute is removed
from the application bundle. HAR-7775

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

Toon Boom Harmony 22.0.3 Release Notes

Harmony 22.0.1 Release Notes
Harmony 22.0.1 build 22.0.1.19338 (2023-03-01)

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

Drawing Toolsl

Using the Close Gap tool while drawing with a tablet may cause a crash. HAR-8828

l

The Paste Drawing Object in Place option doesn’t work when the focus is in the Timeline or Xsheet. HAR-8606

Animation Toolsl

The Shift and Trace tool doesn’t display the drawing as it’s being repositioned. HAR-8458l

Peg holes and cross hairs for the previous drawing disappear after moving the drawing using the Shift and Trace
tool. HAR-8038

Timeline and PlaybacklCreate Cycle messes up the layer’s timing and is not undoable. HAR-3867

l

Frame Markers are not reversed when using the Paste Reverse command. HAR-7385l

A layer set to Outline Mode in the Timeline always displays black in the Camera view. HAR-8573

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

Effectsl

A vector drawing connected to a Planer Region node that is defined to use Vector Drawing, connected to a Sprite
Emitter may cause a crash. HAR-8763

lCertain shading effects may show inconsistent results between 16 bit and 32 bit renderings. HAR-8721

lShine effect produces artifacts when alpha attributes are not set to default values and scene is set to render in 32
bits. HAR-8752

lBokeh effect shimmers when there is slow camera movement. HAR-8803

lBokeh and blur effects render with artifacts when Enable Graphic Card Acceleration is enabled in the Preferences.
HAR-8802

CameralShow Snapshot in the Camera view doesn't display certain effects correctly. HAR-8735l

The camera far clipping plane limit cannot be raised over 1000 units. HAR-8805

11

Toon Boom Harmony 22.0.3 Release Notes

3Dl

3D models and 2D layers disappear when rotating the Perspective view 90 degrees. HAR-8758

DeformerslMinimum and Maximum Distance circles displayed for weighted deformers are not the proper size on a
Retina/HiDPI displays. HAR-8610

l

Minimum and Maximum Distance circles displayed for weighted deformers do not scale with the drawing. HAR8609

l

Using the Transform tool with Control Selection Mode enabled does not work on a newly created deformation
chain. HAR-4650

Nodes and Node Viewl

Crash when entering text in Node View search field. HAR-8850l

A Channel Swap node directly connected to a Display doesn't render correctly. HAR-8728

lCrash after enabling Publish Attribute Mode and the Drawing attribute in the Transformation Switch node. HAR8848

l

Timing Columns options in the Transformation Switch node don’t work correctly. HAR-7796

lRendering is incorrect when an art layer selector node is set to flatten and used in combination with the Animate
Pencil Texture node. HAR-8809

lReducing the alpha channel using a Matte-Resize node doesn’t work if the source image doesn’t have antialiasing.
HAR-8582

Import / ExportlImporting images from scanner locks up after previewing the images. HAR-8818

l

PSD files from Adobe Photoshop 2021 and later are blank in Harmony. HAR-8819

lImages and 3D models disappear from the scene if the file name ends with a v and three digits (-v001). HAR-7118

l[Windows] Pasting an image copied from a web browser does not work. HAR-8796

lPrecision loss and colour banding when writing 8 bit images in JPG, TGA, TIF and SGI if there is a colour spaceconversion. HAR-8826

ScriptinglToon Boom Python API cannot be loaded unless a license with database is available. HAR-8832

l

Add Python Interface Documentation to Help menu. HAR-8769

l

A drawing created using Python script is not flagged as existing on the file system, and cannot be immediately
loaded and rendered. HAR-8856

12

Toon Boom Harmony 22.0.3 Release Notesl

TB_ExportCamera script inverts the camera when some axes are rotated 180 degrees. HAR-8647

l[Linux] Plugins/Scripting packages are not loaded on startup. HAR-8812

l

TB_GameExportWindow.js is not packaged in Harmony 22. HAR-8811l

Add a scripting method, setNumberOf to SCR_FrameInterface, which sets the scene length (moves the end red
handle) without deleting the drawing or keyframe. HAR-7358l

Add missing functions to the ColorOverride class to add and remove colours. HAR-6671

lHarmony crashes when rendering a 3d model via the python scripting interface. HAR-8750

Performancel[macOS] Harmony sometimes crashes when waking from sleep mode. HAR-8359

l[macOS] When running in Japanese the Licence Wizard may crash when installing the licensing service. HAR8694l

The Save Scene Automatically preference does not work correctly when Harmony is left to idle. HAR-6564

l

Top and Side views take a long time to refresh while thumbnails are being rendered. HAR-8760

Devicesl[Windows] Wacom tablet touch gestures for zoom, pan and rotate are not working. HAR-8739

l[Windows] When sizing the Preferences window it may disappear offscreen if display scaling is not 100%. HAR-

UI
8566

Database / Control Centerl

The Update Database Scene error reporting is uninformative and sometimes wrong. HAR-8843

lScene lock information is not displayed correctly in Control Center. HAR-8049

l[macOS] After closing a scene in database mode, Open, Palette Operations and other commands may stop
responding. HAR-8766

Rendering and Pipeline IntegrationlPalettes and palette lists are potentially locked during normal batch rendering. HAR-8667

lHarmony does not work with the LucidLink cloud NAS file system on macOS. HAR-8806

l

Workstations that do not have a GPU may not have the OpenCL libraries installed and will fail loading the plugins
for OpenCL effects such as Blur. HAR-8693

lHarmony is in "Not Responding" state for a long time before generating and uploading a snapshot preview from
Producer. HAR-8817

ltbprocess/queue dependencies between rendering jobs are not correct. HAR-8816

13

Toon Boom Harmony 22.0.3 Release Notes

Other
l

Deleting a column in the Xsheet then undoing, may cause a crash. HAR-8795l

The Metadata Editor is not applying Scene Metadata values correctly. HAR-8748

lScene takes 20 times more time to save on Windows than on macOS. HAR-9049

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

lWhen using Harmony on macOS Big Sur, Harmony may crash when saving a colour in macOS’s native colour
picker. HAR-8032

lDatabase scenes that have a custom path cannot be copied using Control Center. HAR-6386

lStroke remains in place after removing the last point of a branch with the centreline editor. HAR-5994

lWhen using an iPad Pro in Sidecar mode with Harmony, every second click registers as a double-click. HAR-8801

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

lOn macOS Mojave, GateKeeper prevents launching Harmony unless the quarantine extended attribute is removed
from the application bundle. HAR-7775

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

Toon Boom Harmony 22.0.3 Release Notes

Harmony 22 Release Notes
Here is the list of changes in Harmony 22, build 22.0.0.18839 (2022-09-26):

New Features
Drawing Workflow
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 scene'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 scene's models folder, without having to manually
delete them 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.

Live Preview When Drawing with a
Textured Pencil

The Pencil tool now displays the pencil texture as well as the thickness stencil
assigned to the selected pencil preset as the line is being drawn, providing a live
and accurate preview of the final line.

Paste in Place

A new command named Paste Drawing Object in Place is now available in the
Edit menu. Unlike the Paste Drawing Object command, which pastes a copied
drawing object with a slight offset, the new Paste Drawing Object in Place
command always pastes the copied drawing object in the same position as theoriginal. The new command can be accessed from the Edit menu and has theCtrl+Shift+V (Command+Shift+V on macOS) shortcut assigned.

Frame Drawing Selection shortcut

A new shortcut command named Frame Drawing Selection has been added toHarmony. Using this command when a drawing tool is active will centre theCamera or Drawing view on the selected drawing. The default shortcut for this15

Toon Boom Harmony 22.0.3 Release Notes

FeatureDescriptioncommand is Shift+F.

Rendering
FeatureDescription

Internal render operations in Harmony can now be performed using 32 bits perchannel floating point values. This provides more precision and adds support forcolour values below 0 and above 1 for high dynamic range rendering and colour
accuracy.
The bit depth used for internal processing can be changed between 16 bits or
32 bits per channel from the Colour Space tab of the Scene Settings window.

32 Bits Per Channel Rendering Processing

When 16 bits per channel is selected, scenes render as they did with previous
versions of Harmony. When 32 bits per channel (float) is selected, all internal
processing operations are performed with 32-bit floating point precision anddoes not clip colour values to 1. This allows Harmony to preserve colour values
even when an effect raises the values of colours beyond white, which allows
subsequent effects to recover those colours when lowering the values.
New scenes created in Harmony 22 are set to use 32 bits per channel render
processing by default. Scenes from previous versions are set to 16 bits perchannel for backwards compatibility.

Support for 32-bit floating-point EXR
images

Displaying Colour Values

EXR Images saved with 32-bit floating-point colour depth containing values
above 1 can now be read and their values preserved throughout the rendering
process.
Harmony now also has the ability to write EXR images in 32-bit floating-point
colour depth.
The Camera view status bar now displays the colour values of the pixel that isunder the mouse when the Camera view is in Render View mode. Values are
expressed as integers between 0 and 32767 when the scene is set to render in
16-bit per channel and as float values when the scene is set to render in 32-bit
per channel.

16Toon Boom Harmony 22.0.3 Release Notes

FeatureDescription

Effects and Compositing
FeatureDescription

The new Bokeh Blur effect in Harmony simulates how a camera lens blurs outof-focus elements based on the shape of its iris.

Bokeh Blur EffectAnimate Pencil Texture EffectTo simulate depth of field, an alpha matte can be used with this effect to control
the amount of blur applied to different areas of the image. Opaque areas in thealpha matte will fully apply the effect while transparent areas in the alphamatte will not apply the effect. The Bokeh Blur node is available in the NodeLibrary in the Filter > Blur category.

The new Animate Pencil Texture effect node works similarly to the Shake nodebut instead of shaking drawings or the camera in the scene, it applies randomtransformations to pencil line textures. This can be used to add life to drawings
by simulating line boiling that occurs in hand-drawn animation where a newline is drawn for every frame.
The Animate Pencil Texture node can automatically detect when there is atransformation or a drawing change from its input and apply the effect to the17

Toon Boom Harmony 22.0.3 Release Notes

FeatureDescription

texture. There is no need to manually time the effect and maintain the timing
manually.
The Animate Pencil Texture node is available in the Filter category of the NodeLibrary.

The blending modes available in the Blending and Composite-Generic nodes
have been updated to support rendering in scenes set to use 32 bits per channel
processing as well as provide closer results to blend modes from third party
applications.

Improved Blending modes

The list of blending modes was simplified to remove beta and legacy blending
modes. However, to provide backward compatibility, Blending and CompositeGeneric nodes in scenes from previous versions of Harmony will have the fulllist of legacy and beta blending modes. New instances of these nodes will only
list the update list.
Some blend modes require values higher than 1 to be clamped in order toprovide the same result as third party softwares. However, clamping limits theuse of those blend modes in the context of an HDR pipeline. A new Clamping
Mode attribute has been introduced to the Blending and Composite-Genericnodes to control whether values should be clamped or not.

Improvements to the Colour Curve effectnode

The Colour Curve node has been improved and extended to fully support scene
set to render using 32 bits per channel processing.

18

Toon Boom Harmony 22.0.3 Release Notes

FeatureDescription

l

l

l

The new Clamp Output Values attribute can be used to control whether
values should be clamped to the values specified in the Minimum andMaximum fields. This attribute is not available in 16 bit per channel
processing.
The new Extrapolate Curve Bounds attribute will extrapolate the curves
beyond their first and last points. This attribute is not available in 16 bit
per channel processing.
A Zoom slider was added to allow zooming out the graph view andmanipulate points beyond the 0 and 1 range.

Animation
FeatureDescription

New Weighted Deformer Nodes

Four new weighted deformation nodes are now available in Harmony. These canbe used to create different types of weighted deformation systems andindividually control their influence on the overall deformation. Multiple types ofweighted deformer nodes can be used in the same deformation system for more19

Toon Boom Harmony 22.0.3 Release Notes

FeatureDescription

flexibility.
The following new nodes are available:ll

Weighted Point: The Weighted Point node uses the pivot of each peg tocreate the deformation system. Add them to existing Weighted
Deformer systems to apply different influence weights to individual
groups of pegs.
Weighted Curve: Used to define a curve that influences the deformation
system. Three types of curves are available and are built using pegs
connected to the node.

ll

Weighted Line: Creates a straight line defined by the attached pegs. The
resulting line is used to influence the deformation.
Weighted Drawing: Uses a single drawing as an input that is used toinfluence the deformation system. The drawing defines the shape of theinfluence and can be transformed with a peg in order to deform theoverall system.

The new weighted deformation nodes are available in the Node Library under
the Deformation >Weighted category.
The new OGL Controller node provides a pickable controller that can be used asa handle to select a drawing or a peg anywhere in the scene and that would beotherwise difficult to select. OGL Controllers are not visible in software renders
and are only visible in OpenGL.

OGL Controller Node

The node provides basic shapes that can be used as the graphic representationof the handle. A drawing node can also be connected to use as a custom shaped
handle.
This new node is available in the Node Library under the Controller category.

The following improvements were done to the graphical representation andmanipulation of pivots when using the Translate and Transform tools:
Transform and Translate Tool Pivot
Improvementsl

A new preference named Use a Donut-Style pivot in the Transform Tool,
located on the Advanced tab in the Preferences, changes the circularpivot of the Transform to a donut, which allows selecting anchors
located under the pivot through its central hole. This preference isdisabled by default.

20

Toon Boom Harmony 22.0.3 Release Notes

FeatureDescriptionll

A new preference named Allow Temporary-Pivot dragging in camera
view, located on the Advanced tab of the Preferences, disables theinteractive manipulation of the Transform Tool pivot when unchecked.
This preference is enabled by default.
New shortcuts were added to move the position of the temporary
Transform Tool pivot as well as the Translate tool pivot without having
to click and grab it.
lllMove Element or Peg Pivot to Cursor: Moves the selected
Element or the Peg’s pivot to the mouse position while theTranslate Tool is active. The Tab key is assigned as the default
shortcut.
Move Temporary Pivot to Cursor: Moves the Transform Tool’s
temporary pivot to the mouse's current position in the camera
view. The Tab key is assigned as the default shortcut.
Move Temporary Pivot to Default: Resets the Transform Tool’s
temporary pivot to its default position. Default shortcut: Ctrl+Tab
on Windows and Option+Tab on macOS

ScriptingFeatureDescription

Harmony's Python Document Object Model provides a Python representation ofHarmony and its loaded project. This allows for the creation of custom tools andautomation tasks that can be run from within Harmony using the new Python
Script Console, or externally to Harmony from a Python Interpreter.
The Harmony Python module is compatible with Python 3.9 or later. If themodule is imported from Harmony's Python Script Console view, Python 3.9.x is
required.
Python Scripting and Python Script
ConsoleThe Python Script Console will only be available when Harmony is launched in
an environment that provides the Python libraries. The Python libraries path canbe specified using the preference PYTHON_LIB_PATH or by making the python
executable available from the PATH environment variable.
For more information please refer to the Main Page in the Python Interface
documentation. The documentation is available by opening the index.html file in
the Harmony application Documentation folder:
Windows:
C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony 22
Premium\help\python\

21

Toon Boom Harmony 22.0.3 Release Notes

FeatureDescription

macOS:/Applications/Toon Boom Harmony 22 Premium/Harmony 22
Premium.app/Contents/Documentation/python/Updates to Qt Classes

Since updating to Qt 6 for Harmony 21.1 some Qt classes that were part of the
QtScriptBinding packaged in previous versions of Harmony were either
deprecated, replaced or were not included in Harmony 21.1.
All the missing Qt classes are now packaged with Harmony 22.

Fixes
Generall

Focus on Mouse Enter does not always work when the mouse is quickly moved to an OpenGL view. HAR-8218

lTransform tool BBox is at the wrong position when using bitmap drawings with weighted and freeform deformers.
HAR-7787lTransform tool BBox is at the wrong position when a Deformer is used with an Element node that has an offset.
HAR-8464

lPoor performance when a Channel-Swap node is used under a pass through composite. HAR-8340

l

OpenGL compositing order is wrong when an Apply-Peg-Transformationa node is used within a 3D scene. HAR8518

l

Vertex colours from alembic files are missing. HAR-8304

l

The preference Element Node “Animate Using Animation Tools” Default Value is ignored when importing a multilayer PSD. HAR-6845

lHigh Discretizer Spacing values can cause the Envelope Creator to crash. HAR-7396

lLines are not Anti-aliased during playback. HAR-8262

lHarmony may crash when opening a second scene if the node cache is active. HAR-8348

lDisconnecting a cable from a Weighted Deform node sometimes disconnects the wrong cable. HAR-8535

lScan application crashes when attempting to import an image using the Load From File command. HAR-8350l

H.264/MP4 is not available as an export format when running Harmony on an Apple Silicon system. HAR-8188

22

Toon Boom Harmony 22.0.3 Release Notes

Drawingl

Thumbnails are not properly refreshed in the Drawing Substitutions view. HAR-7493

l

The Stroke tool's Draw Stroke as Straight Lines and Connect Line Ends options don’t work. HAR-8416

lVectors are not offset when pasting them multiple times to another art layer. HAR-8436

l

The drawing view does not refresh immediately when changing the Drawing Desk's shift and trace options. HAR8487

l

Tiny gaps at colour junctions after using the Stencil brush in Repaint mode. HAR-8417

Reference ViewlLayers cannot be dragged from the Timeline to Reference (Model) View. HAR-8323

lDragging and dropping a template from the Library to the Reference (Model) View does not work. HAR-8547

l

The Reference View uses the forward delete key rather than delete key to unload drawings. HAR-8539

RenderinglTurbulent Noise shifts when a blur effect is added below. HAR-7789

l

EXR images from “Multi Layer Write” nodes have multiple frames stacked on each other. HAR-8228l

The Alignment Rule attribute has no effect in software renders with certain JPEG files. HAR-7335

Master ControllerslMaster Controller rig state stops being parsed when a small or high value is met. HAR-8412

lAdding or deleting rows and columns does not work from the Master Controller Grid Wizard. HAR-8564

Scriptingl

SCR_DrawingKey always returns null when a drawing key is provided in scripting. HAR-8407

l

Control Center’s scripting interface always renders the “Default” camera if no camera is specified. HAR-8403

lQByteArray cannot be constructed with a string as its constructor's argument. HAR-8497

lInvisible plus (+) and minus (-) buttons in TB_ExportToEaselJS, TB_ExportToSpriteSheets and TB_SelectionPreset.
HAR-8500

Databasel

Link Server does not run on Linux if there is no X-Windows server. HAR-8563

lLocks can be taken on the root folder, preventing locks to any other folders in the database. HAR-8556

lPalettes are locked when batch rendering scenes if colours are recovered. HAR-8536

lImporting scenes in batch mode crashes Control Center if the scene already exists. HAR-8503

23

Toon Boom Harmony 22.0.3 Release Notes

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

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

lWhen using Harmony on Big Sur, Harmony may crash when saving a colour in macOS’s native colour picker. HAR8032

l

Database scenes that have a custom path cannot be copied using Control Center. HAR-6386

lStroke remains in place after removing the last point of a branch with the centreline editor. HAR-5994l

On macOS Mojave, GateKeeper prevents launching Harmony unless the quarantine extended attribute is removed
from the application bundle. The quarantine extended attribute can be removed using the following command in
the Terminal:$ sudo xattr -dr com.apple.quarantine "/Applications/Toon Boom Harmony 21.1
Premium"24