Toon Boom Harmony 17.0.0 Release Notes

The new pen stabilizer can help you draw smooth, stable lines by stabilizing your drawing strokes as you draw, without having to smooth them afterwards. It works by letting you draw a stroke without generating a line immediately, instead it starts generating a line that trails behind your mouse cursor or tablet pen once it reaches a certain length. By trailing behind your stroke, it can smooth out the flaws in your drawing gesture and generate a smooth stroke.

There are two different stabilizing method methods:

• Average: Harmony calculates the average direction of all of your mouse or pen gestures between the end of the actual drawing stroke and the current position of your mouse cursor or pen tip, and extends the stroke in this average direction, effectively evening out jitter and rounding sharp turns.

  

• Pulled String: When you start drawing a stroke, Harmony positions the drawing tool where your stroke starts. As you move the mouse or tablet pen, the drawing tool remains in that position, but a "string" appears, linking your drawing tool to your mouse cursor or pen tip.

  

  Once a certain maximum length is reached, the string pulls the drawing tool in the direction of your mouse cursor or tablet pen.

  

The distance between your mouse cursor or tablet pen and the stroke can be customized.

This feature can be enabled by adding the Pen Settings toolbar to your workspace, and selecting either Average or Pulled String in the toolbar's drop-down menu—see About Pen Stabilization.

If you have a tablet and pen that support reading the tilt angle of your pen, you can configure the Brush tool to use this information and draw with a tilted tip. A tilted tip will be stretched or projected at the angle in which you tip your tablet pen, simulating the effect of drawing with a tilted pencil or felt pen.

This feature can be used by adjusting the Pen Tilt Sensitivity parameter in the Brush Properties dialog—see Brush Tool Properties.

If you have a tablet and pen that supports reading the rotation angle of your pen, you can configure the Brush tool to use this information so that the rotation of your brush tip is based on how you rotate your tablet pen.

This feature can be used by enabling the Use Pen Rotation property in the Brush Properties dialog—see Brush Tool Properties.

Harmony now allows you to configure the curve by which it processes the amount of pressure you put on your pen tablet to calculate the thickness, flow or opacity of your brush or pencil lines.

The Pen Pressure Feel dialog can be accessed by adding the Pen Settings toolbar to your workspace, then clicking on the Pen Pressure Feel button. For more information, see About Pen Pressure Curve Customization and Pen Pressure Feel Dialog Box.

When drawing straight lines with the Brush tool using a pressure sensitive pen tablet, you can drag your pen back over your stroke to adjust or increase its thickness, as if you were drawing with a pressure-sensitive pen against a ruler. There are two different approaches to this:

• If you draw while pressing and holding the Shift key, you will draw a horizontal or a vertical line.
• If you draw while pressing and holding both the Alt and Shift keys, you will draw a straight line in any direction. If you drag your pen in the opposite direction of your line, the angle of your line will lock and you will be able to draw over it.

The Stroke tool now creates smoother lines with less unnecessary control points.

Several new drawing guides have been added:

• The Ruler allows you to position and rotate a simple straight axis, and then draw a line along that axis, like a regular ruler.

  

• The Isometric Perspective guide helps you draw lines that are parallel to one of three axes: The x-axis, the y-axis and the z-axis. The angle of each axis can be customized as needed.

  This type of pseudo-perspective, also referred to as parallel projection, is often used in 2D games, computer graphics and schematics to depict 3D objects and environments without using any actual perspective, foreshortening or 3D rendering. In 2D animation, it is often used to draw long panning backgrounds from a low or high angle.

  

• The 3-Point Perspective (Horizontal Pan) guide helps you draw horizontally panoramic backgrounds, with curvilinear horizontal lines. A vanishing point is placed in the middle of the horizon line, to help draw lines on the z-axis, and two vanishing points are placed on the horizon line outside of the camera field, to define the curve of horizontal lines. Vertical lines are made perpendicular to the horizon line.

  This is useful for drawing backgrounds meant to be panned over horizontally. Panning the camera horizontally over a background drawn with a 3-Point Perspective (Horizontal Pan) guide will simulate a rotation of the camera on the y-axis.

  

• The 3-Point Perspective (Vertical Pan) guide helps you draw vertically panoramic backgrounds, with curvilinear vertical lines. A vanishing point is placed in the middle of the horizon line, to help draw lines on the z-axis, and two vanishing points are placed above and below the horizon line, outside of the camera field, to define the curve of vertical lines. Horizontal lines are made parallel to the horizon line.

  This is useful for drawing backgrounds meant to be panned over vertically. Panning the camera vertically over a background drawn with a 3-Point Perspective (Vertical Pan) guide will simulate a vertical rotation of the camera on the x-axis.

  

• The 4-Point Continuous Perspective guide is very similar to the 3 Point Perspective (Horizontal Pan) guide, except that it is designed to help draw full 360° panoramic backgrounds.

  This guide uses 5 vanishing points. When drawing a horizontal line, it is curved by arching over one of the vanishing points and reaching down to the two surrounding vanishing points. This creates a perspective effect where each vanishing point represents one of the cardinal points, except that the leftmost and the rightmost points represent the same cardinal point, effectively creating a looping background. Backgrounds made with the 4-Point Continuous Perspective guide can be looped horizontally to simulate a full rotation of the camera on the y-axis.

  

• The 4-Point Perspective (Vertical Pan) is a lot like the 2-Point Perspective guide, except that its vertical lines are curvilinear, so it can be used to make vertically panning backgrounds. Two vanishing points are on the horizon line, outside of the camera field, to help draw lines on the x-axis and the z-axis, and two vanishing points are placed above and below the camera field to define the curve of the vertical lines.

  This is useful for drawing backgrounds meant to be panned over vertically, in which cuboid objects are seen from an angle.

  

• The 5-Point Perspective (Fish Eye) guide helps you draw backgrounds that are curvilinear on both the x-axis and the y-axis. It has one central vanishing point on the horizon line, from which lines on the z-axis are drawn, two vanishing points at the extremities of its horizon line, to define the curve of horizontal lines, and two vanishing points above and below the horizon line, to define the curve of the vertical lines.

  This guide can be used to draw backgrounds with a fisheye-style wide angle lens effect. It can also be used to draw backgrounds that are meant to be panned in various directions.

  

Each guide is available in the Add Guide pop-up menu of the Guides view. For more information, see About Drawing Guides.

If you press and hold the Alt key while using drawing guides, the angle of the guide lines will stop following your mouse cursor and lock in position until you release the Alt key, allowing you to keep the guide lines at the right angle.

By using this feature, you can rework the thickness or length of lines that you are drawing with a guide. It's also useful if you want to draw a dotted line along an axis.

It is now possible to add horizontal and vertical guides to the Camera view. Alignment guides are visible when the Transform tool is selected, and can be used to help you align elements to specific areas of the stage.

• You can add guides using the New Horizontal Alignment Guide and New Vertical Alignment Guide buttons in the toolbar above the Camera view.
• You can manipulate alignment guides using the Transform tool.
• You can hide or display guides by toggling the Show Alignment Guides button in the toolbar below the Camera view.
• You can lock or remove alignment guides using the menu commands available when selecting View > Alignment Guides in the top menu.
• You can make elements snap to alignment guides by enabling the Snap to Alignment Guides option of the Transform tool in the Tool Properties view.

For more information, see About Alignment Guides

It is now possible to export a movie in MPEG-4 (.mp4) format.

To export an MP4 movie, select File > Export > Movie from the top menu. Then, in the Video Format drop-down, select H.264/MPEG-4 (*.mp4).

The Shortcuts tab of the Preferences dialog is now its own dialog, the Keyboard Shortcuts dialog.

To access this dialog box, in the top menu, select Edit (Windows) or Harmony Essentials (macOS) > Keyboard Shortcuts.

It is now possible to create your own keyboard shortcut sets. You can also export your keyboard shortcut sets as XML files and use them as backups or share them with project collaborators.

You can create, export and import keyboard shortcut sets using the New, Load... and Save... buttons at the top of the Keyboard Shorcuts dialog.

For more information, see About Keyboard Shortcut Sets.

It is now possible to export your preferences as XML files, and use them as backups or share them with project collaborators.

You can export and import preferences using the new Load... and Save... buttons at the top of the Preferences dialog.

For more information, see Exporting Preferences and Importing Preferences.

Harmony now comes preloaded with five different sets of default preferences, which you can quickly switch between in the Preferences dialog.

Most of the preferences in these sets are the same, except for key workflow preferences such as

Focus on Mouse Enter, Default Separate Position for Pegs, Stop-Motion Keyframes and others. For more information, —see Switching Between Preference Sets.

The Harmony package for macOS now only contains a single application.

You can launch any of the side applications bundled with Harmony, such as License Wizard, by first launching Harmony, then selecting Harmony Essentials > Harmony Tools from the top menu.

It is possible to run scripts on Harmony scenes from the command line by running Harmony with the -batch parameter. However, since scripts are typically used to make changes to a scene, this saves the scene by default.

When running a script in command line on a Harmony Server scene, it is possible to make Harmony execute the script without saving the target scene. To do this, simply add the -readonly parameter to the command.

The viewPosition() method was added to the view class. It returns a QPoint object containing the position of the top-left corner of the specified view, in pixels. The individual coordinates can be obtained by using the x() and y() methods of the returned QPoint object.

For more information, see Harmony Scripting Interface Reference

The setValue(), setValueAt(), getValue() and getValueAt() methods of the Attribute class can now work with Quaternion functions:

• The "set" methods can can now take Quaternion objects as their parameter
• The "get" methods will return a Quaternion object when ran on a Quaternion function.