Toon Boom
Harmony22
Paint Application
Reference Guide

TOON BOOM ANIMATION INC.

+1 514 278 8666

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

contact@toonboom.com
toonboom.com

Harmony 22 Paint Reference Guide

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 w hole or in part is strictly prohibited.
The content of this document is covered by a specific limited w arranty and exclusions and limit of liability
under the applicable License Agreement as supplemented by the special terms and conditions for
Adobe® Flash® File Format (SW F). For details, refer to the License Agreement and to those special terms andconditions.

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 ow ners.

Publication Date
09-23-2022
Copyright © 2022 Toon Boom Animation Inc., a Corus Entertainment Inc. company. All rights reserved.

1

Table of Contents

Table of Contents
Table of Contents

2

Introduction

5

Chapter 1: Dialog Boxes

6

Advanced Save Dialog Box

7

Close Gaps Dialog Box

12

Configure Line Art to Colour Art Dialog Box

13

Create Palette Dialog Box

15

Create Palette from Selection Dialog Box

16

Database Selector Dialog Box

18

Export OpenGL Frames Dialog Box

20

Manage Local Cache Dialog Box

32

Movie Options Dialog Box (macOS)

34

Onion Skin and Light Table Transparency Dialog Box

37

Palette Brow ser Dialog Box

38

Palette Operations Dialog Box

41

Preferences Dialog Box

43

Recolour Draw ings Dialog Box

47

Remove Dirt Dialog Box

49

Remove Hair Dialog Box

50

Set Ease on Keyframes Dialog Box

51

Tint Offset/Blend Dialog Box

53

Toolbar Manager Dialog Box

54

Chapter 2: Tools Properties

56

Brush Tool Properties

58

Centerline Editor Tool Properties

81

Close Gap Tool Properties

83

Colour Eyedropper Tool Properties

84

Contour Editor Tool Properties

85

Cutter Tool Properties

902

Harmony 22 Paint Reference Guide

Draw ing Pivot Tool Properties

95

Edit Gradient/Texture Tool Properties

98

Ellipse Tool Properties

99

Envelope Tool Properties

109

Eraser Tool Properties

112

Ink Tool Properties

134

Line Tool Properties

136

Paint Tool Properties

148

Pencil Tool Properties

155

Pencil Editor Tool Properties

166

Perspective Tool Properties

171

Polyline Tool Properties

174

Rectangle Tool Properties

182

Reposition All Draw ings Tool Properties

192

Select Tool Properties

194

Shift and Trace Tool Properties

207

Smooth Editor Tool Properties

210

Stamp Tool Properties

212

Stroke Tool Properties

220

Text Tool Properties

222

Zoom Tool Properties

225

Chapter 3: Toolbars

226

W orkspace Toolbars

227

Edit Toolbar

228

File Toolbar

229

Tool Presets Toolbar

230

Tools Toolbar

231

W orkspace Toolbar

236

View Toolbars

237

Chapter 4: Views

238

3

Table of Contents

Colour View

239

Draw ing View

246

Integrated Help View

249

Message Log View

250

Reference View

251

Tool Properties View

253

4

Harmony 22 Paint Reference Guide

Introduction
Harmony has several commands, dialog boxes, and buttons. The Reference section lists all of them along w ith
the matching definition. To understand how to use these functions in a production context, read the User
guide.
In the Reference guide, you w ill learn about the various parameters available in dialog boxes, menus, nodes,
toolbars, view s, and w indow s.
The Preferences guide provides additional details about each individual preference.

5Chapter 1: Dialog Boxes

Chapter 1: Dialog Boxes
Dialog boxes contain controls such as options and lists through w hich you can carry out a particular commandor task. For example, in the Scene Settings dialog box, you must indicate the resolution and alignment. A
typical dialog box looks as follow s:
Advanced Save Dialog Box

7

Close Gaps Dialog Box

12

Configure Line Art to Colour Art Dialog Box

13

Create Palette Dialog Box

15

Create Palette from Selection Dialog Box

16

Database Selector Dialog Box

18

Export OpenGL Frames Dialog Box

20

Manage Local Cache Dialog Box

32

Movie Options Dialog Box (macOS)

34

Onion Skin and Light Table Transparency Dialog Box

37

Palette Brow ser Dialog Box

38

Palette Operations Dialog Box

41

Preferences Dialog Box

43

Recolour Draw ings Dialog Box

47

Remove Dirt Dialog Box

49

Remove Hair Dialog Box

50

Set Ease on Keyframes Dialog Box

51

Tint Offset/Blend Dialog Box

53

Toolbar Manager Dialog Box

54

6

Harmony 22 Paint Reference Guide

Advanced Save Dialog Box
In Harmony Server, the Advanced Save dialog box lets you save the scene as a new version, overw rite an
existing version, set a new current version, display a list of modified draw ings, colour palettes, and modified
colour palette lists.

How to access the Advanced Save dialog Box
1. From the top menu, select File > Save....
The Advanced Save dialog appears.

7Chapter 1: Dialog Boxes

File Tab

Parameter

Description‣

Enable this option if you w ant to save the modifications made to thecurrent scene.

Save

‣

Deselect the Save option if you only w ant to save specific components ofyour scene listed in the Draw ings, Palettes or Palette Lists tabs. This w ill
disable all option in the File tab.

This Version (number)

Saves the current version of the scene. You can rename the current version by
typing a new name into the field.

New Version (number)

Saves the current scene as a new version. You can name this new version by
typing a name into the field.

Overw rite Existing Version

Lets you select an existing version of your scene from the list to overw rite it.

Description

Use this field to add or edit an existing description for the scene version you w ant
to save.

Mark as Current

Lets you set this scene version as the current one. This version w ill be
automatically selected as the default current version w hen the scene is selectedin the Database Selector dialog box

8Harmony 22 Paint Reference Guide

Drawings (Harmony Server only)
The Draw ings tab lists the modified draw ings.

Parameter

Description

Draw ing list

Lets you select the modified draw ings to save, and deselect the ones you do not
w ant to save.

Select All

Selects all modified draw ings in list.

Deselect All

Deselects all modified draw ings in the list.

Palettes Tab
The Palette tab lists the modified colour palettes.

9Chapter 1: Dialog Boxes

Parameter

Description

Colour Palette list

Lets you select the colour palette to save, and deselect the ones you do not w ant
to save.

Show Recovered

Displays the recovered palettes in the list of modified palettes.

Select All

Selects all modified colour palettes in the palette list.

Deselect All

Deselects all modified colour palettes in the palette list.

Palette Lists Tab
The Palette Lists tab lists all the modified colour palette lists.

10Harmony 22 Paint Reference Guide

Parameter

Description

Palette Lists

Lets you select the modified palette list to save, and deselect the ones you do not
w ant to save.

Show Recovered

Displays the recovered palettes in the list of modified palettes.

Select All

Selects all modified palette lists in the list.

Deselect All

Deselects all modified palette lists in the list.

11Chapter 1: Dialog Boxes

Close Gaps Dialog Box
The Close Gaps dialog box lets you close up draw ing areas that not are closed. This may sometimes happen
w hen painting. You can close small gaps in a draw ing by creating small, invisible strokes betw een the tw oclosest points to close the colour zone. You do not need to trace directly over the gap. You can draw it a few
millimeters aw ay. The tw o closest points automatically close the gap.

How to access the Close Gaps dialog box
1. Select View >Show Strokes or press K to see a preview of the result.
2. To flatten the strokes you draw , click the Auto-Flatten

button in the Tool Properties view .

3. Select Drawing > Close Gaps or press Shift + F10 (W indow s/Linux only).
The Close Gaps dialog box opens.

Parameter

Description

Size

Lets you set the size of the gap you w ant to be closed.

Apply to all draw ings

Closes all gaps in the draw ing of the selected layer.

12Harmony 22 Paint Reference Guide

Configure Line Art to Colour Art Dialog Box
The Configure Line Art to Colour Art dialog box lets you modify settings for the Line Art and Colour Art layers.

How to access the Configure Line Art to Colour Art dialog box
1. In the Tools toolbar, select the Select tool.
2. In the Tool Properties view , hold dow n the Shift key and click on the Creatre Colour Art from LineArt button.

Parameter

Description

Use rendered version of thedraw ing

Renders the draw ing and vectorize it to calculate the position of the centrelinethat w ill produce the colour art stroke.

Maximum Resolution for
rendered image

The size of the rendered image.

Threshold for renderedimage

The value of grey processed to create the rendered vectorized arts.

Fitting error for rendered
Beziers

This value represents how precise the fitting of the colour art zone in relation to
the line art w ill be.

Source layer

Lets you select the layer (Line Art, Colour Art, Underlay or Overlay) you w ant thecolour art to be created from.

Destination layer

Lets you select the layer (Line Art, Colour Art, Underlay or Overlay) you w ant thecolour art to be created on.

Clear Destination Art Layer

Deletes the content before the colour art is added. This is useful w hen you

13Chapter 1: Dialog Boxes

First

already have artw ork on the destination layer.

Perform Line Art to Colour
Art Operation Immediately

Performs the Create Colour Art from Line Art command w hen you click OK.

14

Harmony 22 Paint Reference Guide

Create Palette Dialog Box
The Create Palette dialog box allow s you to create a colour palette for your scene. Palettes created w ith this
dialog box are added to your scene's palette list, and stored in your scene's palette-library subdirectory.

NOTE
If you have the Advanced Palette Lists preference enabled, the dialog w ill also have a palettebrow ser, w hich allow s you to decide w here the palette is stored and w hether to add it to the sceneor the element's palette list—see Palette Brow ser Dialog Box on page 38.

How to access the Create Palette dialog box
1. Do one of the follow ing:l

In the Colour View , click the New Palettebutton over the palette list.

lFrom the Colour view menu, select Palettes > New

Parameter

Description

New Palette Name

Allow s you to type in the name of the palette to create.

Allow s you choose the palette type to create:

Palette TypelColour: A colour palette can contain colours, gradients and bitmap textures.

l

Pencil Texture: A pencil texture palette can contain textures to apply astransparency filters to pencil lines, in combination to their line colour, to create
various styles of pencil lines.

15

Chapter 1: Dialog Boxes

Create Palette from Selection Dialog Box
The Create Palette from Selection dialog box allow s you to create a palette that contains all the colours usedby all the draw ings in the selected draw ing layers.

This can be useful, for example, if the colour design for a character model or rig, a background or another kindof asset w as made using several different palettes, and you need to consolidate all of the colours used by theasset into its ow n dedicated palette.

NOTES
l

The Create Palette from Selection dialog uses the colours in all the draw ings in the selected
layers, even draw ings that are not exposed.

l

For tasks related to this dialog box, see the User Guide.

How to access the Create Palette from Selection dialog box
1. In the Timeline, Xsheet, Camera or Node view , select one or more draw ing layers.
2. In the top-left corner of the Colour view , open the

View Menu and select Palettes > New

Palette from Selected Drawings.

Parameter

Description

New Palette Name

Allow s you to type in the name of the palette to create.

Allow s you choose one of the type of palette to create:lColour: Creates a palette containing all the colours, gradients and bitmap
textures used in the selected draw ing layers.

l

Pencil Texture: Creates a palette containing all the pencil textures used in theselected draw ing layers.

Palette Type

Generate New Colour
IDs and Recolour
Selected Draw ings

By default, the Create Palette from Selection dialog box generates the palette bycopying the colour sw atches used in the selected draw ings from their original palette
into a new palette, along w ith their colour ID. This means that the colour sw atches in thegenerated palette w ill use the same colour IDs as the ones in the original palettes.

16

Harmony 22 Paint Reference Guide

If you select this option, Harmony w ill generate a palette w ith new colour IDs, and w ill
replace the old colour IDs in your artw ork w ith the new ones. This w ill usually have no
visible effect, and w ill prevent the sw atches in the new palette from having the same
colour IDs as the sw atches you originally used to colour your artw or. W hen tw o palettes
have a sw atch w ith the same colour ID, Harmony uses the sw atch from the top-mostpalette in the palette list.

NOTE
If your artw ork uses Colour-Override effects, the colour IDs used by these ColourOverride w ill not be replaced w ith the new colour IDs, making the Colour-Override
ineffective unless you reconfigure them manually. Hence, you should avoid using
this parameter if you are consolidating the palette of a character rig that uses a lotof Colour-Overrides.

17Chapter 1: Dialog Boxes

Database Selector Dialog Box
The Database Selector dialog box lets you connect to your studio's central database w hen w orking on
Harmony Server.

NOTE
W hen you connect to the database, you cannot create new scenes directly from Harmony. The
available scenes must have been already created using the Control Center module.

How to access the Database Selector dialog box
1. Start Paint
2. In the User Name field, type in your Harmony Server username.
3. Click on OK.
The Database Selector dialog box opens.

Parameter

Description

Environments

Lets you select the scene's environment (project, movie).

Jobs

Lets you select the scene's job (episode, sequence).

18

Harmony 22 Paint Reference Guide

ScenesLets you select the scene.

Get rights to modify thescene

Allow s you to modify the selected version of the scene as w ell as to manage andoverw rite other versions. Other users w ill not be able to open a different versionof the scene until you close the scene.

Get rights to modify thescene version

Allow s you to modify the currently selected scene version only. Unless the Get
rights to modify the scene option is also checked, you w ill not be able to change
other versions of the scene. This allow s other users to modify different versions of
the scene w hile you are w orking on the selected version.

Get rights to modify all scene
assetsAutomatically gets the rights to modify all of the scene's assets, locking otherusers from making changes to them until you close the scene. This means thatyou w ill have the rights to modify all the scene's versions, draw ings, palettes, its
palette list, but not its library folder. If this option is unchecked, draw ings andpalettes w ill be locked unless you unlock them manually. This can allow anotheruser to w ork on the scene's draw ings and palettes in Paint w hile you are w orking
on the scene's timing or staging in Harmony.

Dow nloads the scene's draw ings to your computer before opening the scene.
Harmony w ill then load the draw ings from your computer during the session,
instead of loading them from their original location over the netw ork. This cansignificantly increase performance, especially w ith resource-heavy scenes.

Cache scene assets locally

W hen you save your scene, the updated draw ings w ill be uploaded automaticallyto the database, so you do not have to re-upload them manually.

NOTE
If this option is checked, it may take a w hile to dow nload all of the scene's
assets w hen opening a particularly heavy scene.

VersionIf you saved different versions of a scene, this lets you select one to open.

19

Chapter 1: Dialog Boxes

Export OpenGL Frames Dialog Box
The Export OpenGL Frames dialog box allow s you to export your scene as a sequence of images as they
appear in the OpenGL View mode of the Camera view . This means they are exported w ithout effects,
antialiasing and proper compositing. This allow s you to quickly preview the animation in your scene w ithout
having to w ait through the full rendering process.

How to access the Export to OpenGL Frames dialog box
1. In the top menu, select File > Export > OpenGL Frames.

Parameter

Description

Output

The directory in w hich to export the frames or movie file.
Location

You can click Browse... to open a dialog allow ing you to navigate your file systemand select a directory.

The name of the file to export.
Filename

If you are exporting frames, the file name of each frame w ill start w ith this value,
follow ed by the number of the frame.

FormatImage Sequence

Select this option to create an image sequence.

Movie

Exports the frames into a movie file.

FramesExports each frame as an individual image file.

SuffixAllow s you to select the number of digits in the number used to identify each frame.

20Harmony 22 Paint Reference Guide

Parameter

Description

FormatSpecification

TGA

Full colour

Description

Truevision TGA/TARGA (*.tga)
TGA1

Greyscale

TGA3

Full colour

TGA4

Full colour w ith
transparency

SGI

Full colour / 8 bits
per channel

SGI1

Greyscale / 8 bits
per channel

SGI3

Full colour / 8 bits
per channel

SGI4

Full colour w ith
transparency / 8
bits per channel

SGIDP

Full colour / 16 bits
per channel

SGIDP3Full colour / 16 bits
per channel

SGIDP4

Full colour w ith
transparency / 16
bits per channel

A standard image format w ith losslesscompression and support fortransparency.
TGA files use more disk space thanPNG files, but rendering in TGA isfaster.

Draw ing TypeSilicon Graphics Image (*.sgi)
A highly capable format w ith losslesscompression as w ell as support for
double precision and transparency.

Photoshop Document (*.psd)

PSD

Full colour / 8 bits
per channel

An Adobe Photoshop proprietary
format used for image editing.
PSD files exported by Harmony
contain a single background layer w ith

21Chapter 1: Dialog Boxes

Parameter

Description

FormatSpecification

PSD1

Greyscale / 8 bits
per channel

PSD3

Full colour / 8 bits
per channel

PSD4

Full colour w ith
transparency / 8
bits per channel

Description

the rasterized image.

NOTE
PSD files exported from

PSDDP

Full colour / 16 bits
per channel

Harmony are tagged w ith
their colour space
information in their
metadata, except for PSD

PSDDP1Greyscale / 16 bits
per channel

PSDDP3Full colour / 16 bits
per channel

PSDDP4

Full colour w ith
transparency / 16
bits per channel

files exported in greyscale.

Y'UV frame (*.yuv)
A legacy format optimized for NTSC
television. The image information is
encoded in the Y'UV color space,w hich means Luma (Y') and
Chrominance (UV).
YUV

NOTE
YUV images must be
exported in NTSC
resolution (720 x 540), or
they w ill not be legible.

22Harmony 22 Paint Reference Guide

Parameter

Description

FormatSpecification

Description

PAL frame (*.pal)
A legacy format optimized for PAL
television.

PAL

NOTE
PAL images must be
exported in PAL resolution(768 x 576), or they w ill
not be legible.

Toon Boom Scan Files (*.scan)
A Toon Boom proprietary format usedby Scan to store scanned image
information along w ith its registration(peg), resolution and field chart
metadata. SCAN files are in gresycale.

SCAN

PNG

PNG4

Full colour / 8 bits
per channel

Full colour w ith
transparency / 8
bits per channel

PNGDP

Full colour / 16 bits
per channel

PNGDP3Full colour / 16 bits
per channel

Portable Network Graphics (*.png)
A highly portable image format w ithhigh lossless compression as w ell as
support for transparency and doubleprecision. PNG is typically used for
W eb applications, graphical userinterfaces and image sharing.
Rendering in PNG takes more timethan rendering in TGA or in
uncompressed image formats, but
saves a lot of disk space.

NOTE
PNG files exported from
Harmony are tagged w ith
their colour space

PNGDP4

Full colour w ith
transparency / 16
bits per channel

JPG

information in their
metadata.

Jpeg (*.jpg)

23Chapter 1: Dialog Boxes

Parameter

Description

FormatSpecification

Description

A very compact image format w ith
lossy compression. It is typically used
for W eb pages and photo sharing.
Because it does not preserve image
quality, it is recommended to neverrender in Jpeg format unless you areexporting stills for a W eb page or are
making quick render tests.

BMP

Full colour

Bitmap (*.bmp)

BMP4

Full colour w ith
transparency

A standard uncompressed image
format commonly used on Microsoft
operating systems.

OPT

Full colour

OPT1

Greyscale

OPT3

Full colour

OPT4

Full colour w ith
transparency

Toon Boom Optimized image (*.opt)
A legacy Toon Boom proprietary
format that stores bitmap image dataw ith lossless compression. It supports
transparency.

Toon Boom Variable Header image(*.var)VAR

A legacy Toon Boom proprietary
format that stores greyscale bitmap
image data w ith lossless compression.

Tagged Image File Format (*.tiff)
An image format w ith many
compression and encoding settings. It
is often used for image exchange invisual arts and publishing.

TIF

TIFF images exported by Harmony areuncompressed, encoded on a per-pixel(interleaved) basis in PC byte order.

24

Harmony 22 Paint Reference Guide

Parameter

Description

FormatSpecification

DPX

8 bits per channel /Full color / RGB
channel order

DPX3_88 bits per channel /Full color / RGB
channel order

DPX3_1010 bits per channel/ Full color / RGB
channel order

DPX3_12

12 bits per channel/ Full color / RGB
channel order

DPX3_16

16 bits per channel/ Full color / RGB
channel order

DPX3_10_
INVERTED_CHANNELS

10 bits per channel/ Full color / BGR
channel order

DPX3_12_
INVERTED_CHANNELS

12 bits per channel/ Full color / BGR
channel order

DPX3_16_
INVERTED_CHANNELS

16 bits per channel/ Full color / BGR
channel order

Description

Digital Picture Exchange (*.dpx)
A professional photo format that
supports various different approaches
to storing colour information, w hichcan be used for storing, exchanging
and editing raw information recordedby cameras. It is commonly used in film
production.

OpenEXR (*.exr)

EXR

16 lines Zip
compression

25

A highly capable deep image format.
Each pixel in an EXR file is exported
w ith its Z-depth information.
Additionally, if a pixel is semitransparent, the color and depth
information of pixels further back isstored along w ith it. If your scene has

Chapter 1: Dialog Boxes

Parameter

Description

FormatSpecification

Description

multiplane or 3D elements, this format
can be used for compositing youranimation w ith other graphicalelements in 3D animation softw are.

NOTES
l

OpenEXR files
exported from
Harmony are tagged
w ith the w hite point
and primaries
coordinates for theircolour space.

EXR_ZIP_1LINE

1 line Zip
compressionl

OpenEXR files are
alw ays exported by
Harmony alw ays have
1 line Zip compression
if they contain a 3D
image.

Portable Document File (*.pdf)
Typically, PDF files are used to store,archive, share and print documents.
How ever, Harmony uses the PDF
format for its capability to store bitmap
images and vector graphics.
PDF

If the w rite node is connected to avector draw ing layer or to a vector
composite, the exported PDF files w ill
contain the image as a vector graphic.
It w ill ignore bitmap layers, effects anddeformations. Otherw ise, the PDF files
w ill contain the rendered image as a
bitmap.

Deep Texture (*.dtex)
A commonly used deep image format.
Each pixel in an DTEX file is exported
w ith its Z-depth information.
Additionally, if a pixel is semitransparent, the color and depth

DTEX

26

Harmony 22 Paint Reference Guide

Parameter

Description

FormatSpecification

Description

information of pixels further back isstored along w ith it. If your scene has
multiplane or 3D elements, this format
can be used for compositing youranimation w ith other graphicalelements in 3D animation softw are.

NOTE
Exporting in Deep Texture
requires RenderMan to beinstalled on the machine
and the path toRenderMan properly
configured in Harmony.
For more information, see
the Setting 3D Renderer
Paths topic of the User
Guide.

Drop list w ith all formats listed alphabetically.

Image Format

l

BMP

l

DPX

l

DTEX

l

EXR

l

JPG

l

OPT

l

PAL

l

PDF

l

PNG

l

PSD

l

SCAN

l

SGI

l

TGA

l

TIF

27

Chapter 1: Dialog Boxes

Parameter

Description

l

TVG

l

VAR

l

YUV

Drop list w ith colour modes. Available modes depend on the selected file type.
l

GreyscalelColourlColour + Alpha

Colours

Drop list w ith bit depth value and a label next to it "bits/channel". Available bit depth
depends on the selected file type.
Depth(bits/channel)

l

8

l

10

l

12

l

16

Drop list that appears for EXR and TIF formats only.
l

Zip (per scanline)l

Zip (16 scanlines)

Compression

Inverted Channels

A checkbox that appears for DPX only in 10, 12, 16 bit depths.

Opens the movie settings dialog box for your selected video format, in w hich you can
set the video and audio compression settings for your video file:

Movie optionslQuickTime Movie (*.mov) on W indow s: Movie Options Dialog Box (macOS),l

QuickTime Movie (*.mov) on macOS: QuickTime Movie Settings Dialog Box(W indow s)l

W indow s Media Video (*.w mv): W indow s Media Video Settings Dialog Box(W indow s)

NOTEThis button is available on W indow s and macOS only.

28Harmony 22 Paint Reference Guide

Parameter

Description

Opens the video settings dialog box, w hich allow s you to set the video compression
settings for your video file—see OpenQuickTime Video Options Dialog Box.
Video options

NOTE
This button is available on GNU/Linux only.

Opens the audio settings dialog box, w hich allow s you to set the audio compression
settings for your video file—see OpenQuickTime Sound Options Dialog Box.
Sound options

NOTE
This button is available on GNU/Linux only.

Allow s you to choose one of the follow ing movie formats:l

QuickTime ProRes Movie (*.mov): The Apple QuickTime format. This is thedefault export format and is recommended for its portability, and also
because it allow s you to choose among several video codecs.

NOTES

Movie Formatll

On W indow s, Apple QuickTime must be installed to allow
Harmony to export QuickTime movies. You can configure the exportof QuickTime movies to use any codec that is compatible w ith
QuickTime, including H.264, MPEG-4 and Animation.

l

On macOS, Harmony uses Apple AVFoundation to export
QuickTime movies, w hich allow s you to export using codecs such as
H.264, Apple ProRes 422 and Apple ProRes 4444, among others.

l

If you are looking to export a QuickTime movie w ith transparency,
be sure to choose a codec that supports encoding w ith an alphachannel.

l

On GNU/Linux, Harmony uses the OpenQuickTime library to export
QuickTime movies. This only allow s you to export videos in nonproprietary formats such as Motion-JPEG, Photo JPEG, PNG or
Uncompressed (RGB).

H.264/MPEG- 4 (*.mov) : A simple movie format that uses the H.264 codec,
w hich is supported by most w eb brow sers.

29

Chapter 1: Dialog Boxes

Parameter

Description

NOTES

l

l

Using this format does not require additional softw are. How ever, if
this is the first time you export a movie in H.264/MPEG-4 format,
you w ill be prompted to dow nload the OpenH264 library from
Cisco. Simply click Yes w hen prompted, and Harmony w ill
automatically dow nload the library, then export the movie.

lThere are no encoding options for this format.

lThis format supports resolutions of up to 4096×2304. Eachdimension must be a multiple of 16 pixels.

l

Audio exported in this format is encoded in PCM 16-bit stereo,
22.05 kHz.

W indows Media Video (*.wmv): The native format for W indow s Media
Player.

NOTESlW indow s Media Video (.wmv) files can only be exported on
W indow s.

lVideo players and editors on non-W indow s systems can generally
not open W indow s Media Video (.wmv) files.

Options

If checked, the exported images or movie w ill be opened after the export is finished:l

If you are exporting frames, they w ill be opened in the Play application.

l

If you are exporting a movie, it w ill be opened in your operating system’s
movie player.

Open in Player

Allow s you to specify a resolution to export in, relative to your scene's actual
resolution:lSame as Scene Resolution: Exports a movie in the same resolution as yourscene's resolution.

l

3/4 of Scene Resolution: Exports a movie at 75% of the scene's w idth andheight.

l

1/2 of Scene Resolution: Exports a movie at 50% of the scene's w idth andheight.

l

1/4 of Scene Resolution: Exports a movie at 25% of the scene's w idth andheight.

Resolution

30

Harmony 22 Paint Reference Guide

Parameter

DescriptionlCustom: Allow s you specify the preferred resolution of your exported video
file, in pixels, in the W idth and Height fields.

Allow s you to specify the range of frames in your scene to export:l

All Frames: Exports all the frames in your scene.

l

From / to: Allow s you to specify the frame range to export using the tw o
input fields to the right. The first input field is for specifying the first frame toexport, and the second one is for specifying the last frame to export. All theframes in-betw een, including the ones specified, w ill be exported.

Range
l

Current Frame: Exports the current frame only.

lSelected Frames: Allow s you to select w hich frames to export. You canenable or disable exporting a specific frame by clicking on it. You can also
toggle exporting a range of frames by clicking and dragging over that range inthe list.

OK

Exports OpenGL frames w ith the selected settings and closes the dialog box.

CancelCloses the dialog box w ithout exporting anything.

31

Chapter 1: Dialog Boxes

Manage Local Cache Dialog Box
The Manage Local Cache dialog box displays a list of all the Harmony Server scenes for w hich you havecached draw ings. In this dialog, you can check if the draw ings you have in a scene's cache match the draw ings
in the database server, you can delete unused caches and you can change the directory in w hich scene data iscached.

NOTE
A scene's data is cached on your computer w hen you check the Cache scene assets locally option
in the Database Selector before opening the scene—see Database Selector Dialog Box on page18.

How to access the Manage Local Cache dialog box
1. In the top menu, select File > Manage Local Caches.
The Manage Local Caches dialog appears.

Parameter

Description

The list of caches stored on your computer. There is one item for each scene for w hich there iscached data. Each item is identified by the scene's environment, follow ed by its job, then its
name, in this format:
List of scene
cachesEnvironment/Job/Scene
If you select a scene cache in the list, the Manage Local Caches dialog w ill compare thedraw ings that are cached on your computer to the draw ings in the actual scene in the
database, and report if they are identical or not in the Local Cache Status field.

32Harmony 22 Paint Reference Guide

Parameter

Description

If you select a cache, the Manage Local Cache dialog w ill analyze w hether the data in theselected cache matches the data in the actual scene in the Harmony Server database.
If it displays Scene's Local Cache is identical to the database, then the draw ings in theselected cache on your computer are identical to the draw ings in the corresponding scene in
the database, meaning that your cache and that the database are up to date.
If it displays Scene's Local Cache is different than database, then some draw ings in theselected cache on your computer are different from the draw ings in the corresponding scene in
Local Cache
StatusLocal Cache
Root Folder

the database. This usually means one of the follow ing:l

If the selected cache is the cache of the currently opened scene and you just saved yourscene, Harmony may still be uploading the updated draw ings to the database. In thiscase, you can close the dialog, w ait a few seconds, and reopen it to see if Harmony isdone uploading the draw ings. If it is, it w ill report that the cache is identical to the
database.

l

If this is not the cache of the currently opened scene, it is likely that the database scene
has been changed by someone else since the last time you opened it. That w ould meanthat the database version is more up to date than your cache. This is not a problem, as
next time you open the scene, your cache w ill be updated.

Indicates w here scene caches are stored on your computer. By default, scene caches are stored
in a folder named Toon Boom Harmony Local Cache, inside your Documents folder.

Allow s you to change the folder w here caches are dow nloaded w hen you open a scene.

Brow seNOTE
The caches that are currently stored on your machine w ill not be moved to their new
location. Hence, w hen you change the local cache root folder, the list of scene caches w ill
become empty until you open a scene.

Deletes the selected scene cache from your computer.

RemoveNOTEThis button is greyed out if the selected scene cache is for the currently opened scene, as
this cache is currently in use by Harmony.

Close

Closes the dialog.

33

Chapter 1: Dialog Boxes

Movie Options Dialog Box (macOS)
The Movie Options dialog box allow s you to configure the video and audio settings w hen exporting a movie in
QuickTime Movie (.mov) format on macOS.

NOTES
l

For tasks related to this dialog box, refer to the User Guide.

How to access the Movie Settings dialog box
1. From the top menu, select File > Export > Movie.
The Export Movie dialog box appears.
2. In the Movie Format drop-dow n, select QuickTime ProRes Movie (*.mov).
3. Click on the Movie Options button.
The QuickTime Movie Options dialog box appears.

34Harmony 22 Paint Reference Guide

4. In the Codec drop-dow n, select any of the movie options.

How to access the Movie Settings dialog box from the Export OpenGL Frames dialog
1. In the top menu, select File > Export > OpenGL Frames.
The Export OpenGL Frames dialog box appears.
2. In the Format section, select Movie.
3. In the Movie Format drop-dow n, select QuickTime Movie (*.mov).
4. Click on the Movie Options button.

Parameter

Description

Video

Allow s you to select w hich algorithm to use to compress the video data. The follow ing
video codecs are supported:l

H.264 Legacy: A very effective lossy compression algorithm that is commonly
supported by w eb brow sers and media players.

lH.265 Legacy: Same compression quality as H.264, but w ith a smaller compression
size. This is useful for videos intended for the w eb and mobile devices. Not
supported on all major brow sers or operating systems.

lApple ProRes 422 Legacy: A nearly lossless compression algorithm commonlyused for video editing on Apple systems. This codec is optimized for preserving
video quality, but not for publishing or streaming.

lApple ProRes 422 HQ Legacy: Preserves visual quality at the same high level asApple ProRes 4444 but for 4:2:2 image sources (cleaner footage for things likegreen screening). Heavier than Apple ProRes 422 for real-time editing performance.

lApple ProRes 422 LT Legacy: A more highly compressed codec than Apple ProRes

Codec

35

Chapter 1: Dialog Boxes

Parameter

Description

422, w ith roughly 70 percent of the data rate and 30 percent smaller file sizes. This
codec is perfect for environments w ith limited storage capacity and data rates.
lApple ProRes 422 Proxy Legacy: An even more highly compressed codec thanApple ProRes 422 LT, intended for use in offline w orkflow s that require low data
rates but full-resolution video.

lApple ProRes 4444 Legacy: A nearly lossless compression algorithm commonlyused for video editing on Apple systems. Compared to Apple ProRes 422, this codec
preserves more colour detail and supports transparency. How ever, it results inheavier file sizes.

Check this option if you w ant to export a video w ith transparency.

Alpha

NOTE
This option is only available w hen exporting w ith the Apple ProRes 4444 codec. Other
codecs do not support transparency.

Sound

Uncheck this checkbox if you w ant to export a movie w ithout an audio track.

Allow s you to select the sample rate, or frequency, in w hich to export the audio track for themovie.

Rate

NOTE
Harmony cannot export audio at a higher sample rate than 22.050 kHz. If you select ahigher sample rate, your project's audio w ill be upsampled, w hich means it w ill takemore disc space w ithout increasing in quality.

Allow s you to select w hether to export the movie's audio track using the Mono or Stereo
channel mode.
Use

NOTE
Stereo sound has a separate track for the left and right speakers, w hereas mono soundonly has a single audio track for all speakers.

36

Harmony 22 Paint Reference Guide

Onion Skin and Light Table Transparency Dialog Box
T-ANIMPA-006-009
This dialog box lets you adjust the Onion Skin and Light table transparency parameters.

How to access the Onion Skin and Light Table Transparency dialog boxl

In the Draw ing view toolbar, click on the Top Lightbutton to open the Onion Skin and Light

Table Transparency dialog box.

Command

Description

Onion Skin Opacity

Sets the maximum opacity value for the onion skin opacity display. Moving theslider all the w ay to the left = 0% opacity. Moving the slider all the w ay to theright = 100% opacity.

Lighttable Opacity

Sets the maximum opacity value for the light table display. Moving the slider all
the w ay to the left = 0% opacity. Moving the slider all the w ay to the right =100% opacity.

LightTable W ash

Sets the w ashed-out value for the light table display. Moving the slider all thew ay to the left = 0% opacity. Moving the slider all the w ay to the right = 100%
opacity.

Bitmap Background
W ash

Sets the maximum opacity value for the background w ash. Moving the slider all
the w ay to the left = 0% opacity. Moving the slider all the w ay to the right =100% opacity. Only w orks for bitmap layers.

Pencil Lines Opacity

Sets the maximum opacity value for central vector lines (lines made by the
Pencil or Shape tools). Moving the slider all the w ay to the left = 0% opacity.
Moving the slider all the w ay to the right = 100% opacity.

37Chapter 1: Dialog Boxes

Palette Browser Dialog Box
The Palette Brow ser dialog allow s you to decide the level of palette list and palette storage to use w hen you
w ant to create, clone, link to or import a palette.
This dialog only appears if you have the Advanced Palette Lists preference enabled, w hich is disabled bydefault. W hen Advanced Palette Lists mode is disabled, Harmony automatically stores palettes in a scene's
palette list, inside the scene's palette-library subdirectory.

How to access the Palette Browser dialog box
1. Start Paint and log in.
2. Close the Database Selector dialog box.
3. From the top menu, select Tools > Palette Operations.
4. In the Palette Operations dialog box that opens, select the palette you w ant to clone at the locationand level in w hich it w as stored.
5. Click Clone.

Parameter

Palette Location

Description

This allow s you to brow se for the physical location of the palette file in yourdatabase.
If you are using Harmony Stand Alone, you can still select the scene's ow n job or38Harmony 22 Paint Reference Guide

environment as a location. Stand alone scenes have a provisional job andenvironment storage space inside the scene's directory. The files in these storage
spaces can be imported into a database scene's actual job and environment w hen
importing the scene to a Harmony database. If you never intend to use Harmony
Server, you should keep your palettes inside your scene or element's palette
libraries.

Stores the palette file in the selected environment's palette library. Environments
are typically used to contain a w hole production, series or feature film.
l

In Harmony Server, this stores the palette in /USA_DB/environments/[environment name]/palette-library.

l

In Harmony Stand Alone, this stores the palette inside the scene's
directory, under environments/Digital/palette-library.

Environment

Stores the palette file in the selected job's palette library. Jobs are typically used
to contain episodes in a series, or any set of scenes that is intended to be put inthe same sequence.
Jobl

In Harmony Server /USA_DB/jobs/[job name]/palette-library.

l

In Harmony Stand Alone, this stores the palette inside the scene's
directory, under jobs/Digital/palette-library.

Scene

Stores the palette file in the selected scene's palette library, w hich is thepalette-library subdirectory of the scene's directory.

Element

Stores the palette file inside the selected element's palette library. This library is
located inside the scene's directory, under elements/[elementname]/palette-library.

PaletteThis lists the existing palettes in the selected location.

New Palette Name

If you are creating or cloning a palette, use this field to enter the palette file's
name. The palette w ill be listed under this name in your palette list. On your filesystem, it w ill be named after its palette name, follow ed by the extension .plt.

W hen creating a palette, you can choose betw een the follow ing palette types:lColour: A colour palette can contain colours, gradients and bitmap
textures.

l

Pencil Texture: A pencil texture palette can contain textures to apply astransparency filters to pencil lines, in combination to their line colour, tocreate various styles of pencil lines.

Palette Type39

Chapter 1: Dialog Boxes

Palette List

Scene Palette List

This allow s you to decide if you w ant the palette to be added to your scene's
palette list, or to the currently selected element's palette list.

Adds the palette to the scene's palette list. Palettes in the scene's palette list areavailable to all the elements in your scene. This is especially useful if you aredoing digital animation, w here character models can be made of many layers thatneed to use the same palette.

Adds the palette to the currently selected element's palette list. Palettes in an
Element Palette List

element's palette list can only be used by the draw ings in this element, and w ill
only be listed in the Colour view w hen this element is selected. This can be useful
if you are doing traditional animation, w here each character is usually draw n on asingle layer, and you w ant each layer to have its ow n palette.

40Harmony 22 Paint Reference Guide

Palette Operations Dialog Box
W hen you start Toon Boom Harmony connected to the database, you can access the Palette Operations
dialog box w hich lets you clone, rename, or delete palettes in your database, w ithout having to open a sceneor brow se the database's file system in your operating system's shell.
In Harmony, palettes are individual *.plt files that can be copied, transferred and stored. W hen a palette is
created from Harmony, it needs to be stored somew here. By default, the palette file is stored in the scene
directory in a palette-library folder unless you specify a different location.
There are four locations w here you can find palette-library folders: Element, Scene, Job and Environment.

How to access the Palette Operations dialog box
1. Start Paint and log in.
2. Close the Database Selector dialog box.
3. From the top menu, select Tools > Palette Operations.

Parameter

Description

Environment

The production, project, feature film or series.

Job

The episode and sequence from each environment.

Scene

The scenes from each job.

Element

The layers and columns in each scene.

PaletteThe scene palettes.

Description

Notes, if any, of the project.

41

Chapter 1: Dialog Boxes

Clone

Opens the Palette Brow ser dialog box from w hich you can select the level inw hich to store the palette file.

RenameLets you rename a palette.

Lets you delete a palette.

DeleteNOTE
It is not recommended to disable the w arning message that appears w hen
you are attempting to delete a palette as this operation cannot be undone.

Close

Closes the Palette Operations dialog box.

42

Harmony 22 Paint Reference Guide

Preferences Dialog Box
The Preferences dialog box allow s you to adjust preferences to suit your w orkflow and your production's
needs.

NOTE
For a list of all the preferences as w ell as their functionality, refer to the Preferences guide.

How to open the Preferences dialog box
1. Do one of the follow ing:ll

W indows or GNU/Linux:l

In the top menu, select Edit > Preferences.

l

Press Ctrl + U.

macOS:l

In the top menu, select Harmony [Edition] > Preferences.

l

Press ⌘ + U.

43

Chapter 1: Dialog Boxes

Parameter

Description

This drop-dow n allow s you to select among one of the available preference presets.
The different preference presets have a lot of settings in common. The follow ing table lists how eachpreset differs for specific preferences:

Preference Set
Tab /Location

GeneralPreference SetTimeline

AdvancedPreference
Basic

Compositing

CutoutAnimationPaperless
Animation

Rigging

Focus on
Mouse
Enter

Off

On

On

On

On

Default
Separate
Position for
Pegs

Off

Off

On

Off

On

StopMotion
Keyframes

Off

Off

On

Off

On

ReduceIndentation

Off

On

On

Off

On

Drawing
Substitutio
n: Create
Key
Exposure

On

Off

Off

Off

On

SupportOverlayandUnderlay
Arts

Off

On

On

Off

On

Advanced
Palette List

Off

On

On

On

On

44

Harmony 22 Paint Reference Guide

Parameter

Description

Preference Set
Tab /Location

PencilTool
Properties

Preference
Basic

Compositing

CutoutAnimationPaperless
Animation

Rigging

Advanced
Element
Mode

Off

On

Off

Off

Off

Element
Node
AnimateUsing
Animation
Tools

On

On

Off

On

Off

Auto Close
Gap

On

On

On

On

Off

Save...

Allow s you to export your current preference settings as an XML file, w hich you can import later.

Load...

Allow s you to brow se for and import a preference file that w as exported w ith the Save... button.

W here you can brow se for and change preferences.
Preference TabsNOTE
For a list of all the preferences as w ell as their functionality, refer to the Preferences guide.

RestoreAll
Defaults

Restores all your preferences to their default setting for the selected preference set.

OK

Commits your changes to the preferences and closes the dialog.

45

Chapter 1: Dialog Boxes

Parameter

Description

CancelUndoes your changes to the preferences and closes the dialog.

46

Harmony 22 Paint Reference Guide

Recolour Drawings Dialog Box
The Recolour Draw ing dialog box allow s you to replace all instances of a colour or texture in draw ings w ith adifferent colour or texture sw atch in one of the scene's palettes. This replaces the colours or textures in thedraw ings w ithout requiring you to modify the palettes. You can use this dialog to perform colour replacementin the current draw ing, in all the draw ings in one or several layers or in all draw ings in your scene.
This dialog w ill replace the colour or texture that is currently selected in the Colour view w ith the colour or
texture that you select inside the dialog.

How to access the Recolour Drawings dialog
1. In the Colour view , select the colour or texture sw atch you w ant to replace by doing one of thefollow ing:lSelect the palette in w hich the colour or texture sw atch is located, then select the sw atch
you w ish to replace.

l

If the draw ing in the Camera or Draw ing view contains the colour or texture you w ant toreplace, select the Colour Eyedropper

tool in the Tools toolbar, then click on that colour

or texture in the draw ing. The Colour view w ill automatically select that colour or texture's
palette as w ell as that colour or texture's sw atch.

47

Chapter 1: Dialog Boxes

2. Do one of the follow ing:lRight-click on the sw atches list, then select Recolour Drawings.

lOpen the Colour view menu

Parameter, then select Colours > Recolour Drawings.

Description

Allow s you to select w hich draw ings w ill be affected by the colour replacement:lCurrent drawing: Replaces the selected colour in the currently selecteddraw ing only.

l

All drawings in the currently selected layers: Replaces the selectedcolour in all the draw ings in the layer that is currently selected in theTimelime or Xsheet view .

Replace Colour In

NOTEThis option can w ork w ith several draw ing layers selected.

lReplacement Colour

All drawings in the scene: Replaces the selected colour in every draw ing
in the current scene.

Allow s you to select the palette and colour or texture sw atch to replace theselected colour or texture w ith.

48

Harmony 22 Paint Reference Guide

Remove Dirt Dialog Box
The Remove Dirt dialog box lets you select small dots and hairs on a draw ing for removal.

W hen paper draw ings are passed through a scanner, there can be some hair and dirt scattered across them.
These lines and dots need to be cleaned. Harmony provides different tools to help get rid of them quickly.

How to access the Remove Dirt dialog box
1. Do one of the follow ing:l

From the top menu, select Drawing > Remove Dirt.

l

Press Shift + D.

Parameter

Description

Lets you adjust the amount of detail removed from the layer.

SliderRaising the Remove Dirt level w ill select bigger dots. W hen selecting larger dots,
be careful not to lose small details like pupils and nostrils. Once you have chosen
the level, you can apply it to the current draw ing or the entire animation
sequence. This is a quick w ay to get rid of most dirt and dust.
During this process, the dirt that w ill be removed is highlighted in red.

Apply to all draw ings

Applies the operation to all draw ings in the layer.

49

Chapter 1: Dialog Boxes

Remove Hair Dialog Box
The Remove Hair dialog box lets you remove any small strokes created in the Colour Art layer from very thicklines or filled zones. Increasing the Remove Hair level value w ill select larger strokes for removal from thedraw ing.

W hen paper draw ings are passed through a scanner, there can be some hair and dirt scattered across them.
These lines and dots need to be cleaned. Harmony provides different tools to help get rid of them quickly.

How to access the Remove Hair dialog box
1. Select the draw ing containing the draw ing to clean.
2. From the top menu, select View > Show Strokes to display the invisible lines or press K.
3. In the top menu, select Drawing > Remove Hair.

Parameter

Description

SliderLets you adjust the number of length of hairs selected.

Apply to all draw ings

Applies the operation to all draw ings in the layer.

50Harmony 22 Paint Reference Guide

Set Ease on Keyframes Dialog Box
The Set Ease on Keyframes dialog box allow s you to quickly change the percentage of ease before and after aselection of keyframes.

This dialog box is designed to quickly adjust the “time ratio” of the ease on your animations. To give you abetter idea of its effect, select a keyframe and open the Set Ease for Multiple Paramters dialog box. This dialog
box allow s you to adjust the ease of your animations using Bezier handles. Moving the Bezier handle laterally
changes the time ratio of the ease, and moving it vertically changes its value ratio—see Set Ease for Multiple
Parameters Dialog Box.

How to access the Set Ease on Keyframes dialog box
1. In the Timeline view , select one or several animation keyframes.
2. In the Timeline toolbar, click on the

Set Ease on Selected Keyframes button.

The Set Ease on Keyframes dialog box appears.

Parameter

Description

Allow s you to adjust the ease left of the selected keyframes.
Ease In (left)l

If the checkbox is unchecked, the ease left of the selected keyframes w ill be

51

Chapter 1: Dialog Boxes

Parameter

Description

unchanged.
l

If the checkbox is checked, the ease left of the selected keyframes w ill be set to thepercentage in the input-field right of the checkbox.

Allow s you to adjust the ease right of the selected keyframes.
lEase Out (right)

If the checkbox is unchecked, the ease right of the selected keyframes w ill beunchanged.

l

If the checkbox is checked, the ease right of the selected keyframes w ill be set to thepercentage in the input-field right of the checkbox.

OK

Applies the selected changes and closes the dialog box.

CancelCloses the dialog box w ithout making any changes.

52

Harmony 22 Paint Reference Guide

Tint Offset/Blend Dialog Box
You can offset, blend, or mix the colours in a colour palette using the sliders and increasing the Amount value.

How to access the Tint Offset/Blend dialog box
1. From the Colour View menu, select Palettes > Tint Panel or right-click and select Tint Panel.
The Blend/Offset Tint panel opens.

Parameter

Description

OffsetOffsets the selected colours by the adjustments made using the HSB and RGB
sliders. Use the Amount slider to adjust the degree of offset. Use the Alpha slider
to adjust the opacity of the selected colour.

Blend

Blends the selected colours w ith the colour sw atch in the top-right corner. Use
the Amount slider to adjust the degree of blend. A blend of 100% turns theselected colours into the same colour as the sw atch. Adjusting the HSB and RGB
sliders affect the sw atch colour, w hich in turn affects the selected colours on theleft. Use the Alpha slider to adjust the opacity of the sw atch.

Mixer

Select a Base and Tint colour to form a third colour sw atch. Use the slider justbeneath to mix the Base and Tint colours by different amounts. This w ill affectthe mixed sw atch w hether it is selected or not. Select either the Tint or Basesw atch and use the HSB and RGB sliders to adjust its colour. This w ill affect themixed sw atch colour, w hich in turn affects the selected colours on the left.

53

Chapter 1: Dialog Boxes

Toolbar Manager Dialog Box
The Toolbar Manager dialog box lets you customize the toolbar in any of the view s. You can add your favourite
tools to a toolbar for an efficient w orkflow .

How to access the Toolbar Manager dialog box
1. Right-click on a toolbar in any view and select Customize. Note that the menu w ill not appear if
you right-click on a disabled icon.

Parameter

Description

Available Tools

Displays the complete list of tools available for customizing a toolbar.

Toolbar

Displays a list of the tools currently available on the toolbar.

Default

Restores the toolbar w ith its default items.

54Harmony 22 Paint Reference Guide

55

Chapter 2: Tools Properties

Chapter 2: Tools Properties
Harmony has a w ide variety of draw ing and manipulation tools and each one of them has a series of options
and modes available in the Tool Properties view . This section covers these options.

Brush Tool Properties

58

Centerline Editor Tool Properties

81

Close Gap Tool Properties

83

Colour Eyedropper Tool Properties

84

Contour Editor Tool Properties

85

Cutter Tool Properties

90

Draw ing Pivot Tool Properties

95

Edit Gradient/Texture Tool Properties

98

Ellipse Tool Properties

99

Envelope Tool Properties

109

Eraser Tool Properties

112

Ink Tool Properties

134

Line Tool Properties

136

Paint Tool Properties

148

Pencil Tool Properties

155

Pencil Editor Tool Properties

166

Perspective Tool Properties

171

Polyline Tool Properties

174

Rectangle Tool Properties

182

Reposition All Draw ings Tool Properties

192

56

Harmony 22 Paint Reference Guide

Select Tool Properties

194

Shift and Trace Tool Properties

207

Smooth Editor Tool Properties

210

Stamp Tool Properties

212

Stroke Tool Properties

220

Text Tool Properties

222

Zoom Tool Properties

225

57

Chapter 2: Tools Properties

Brush Tool Properties
The Brush tool allow s you to draw by creating shapes based on your draw ing strokes and filling them w ith
colour or textures. W hen used w ith a tablet, it is pressure sensitive, just like a real life brush.

How to access the Brush tool properties
1. In the Tools toolbar, select the Brushtool.

The tool's properties are displayed in the Tool Properties view .

Brush Properties
The follow ing properties affect the brush's size, smoothing and other properties for the draw ing style of yourbrush. Those properties can be saved into brush presets for later use.
Property

Description

The Preview area lets you see a preview of the stroke your draw ing tool w ill make.
Preview Area

Brush Properties Dialog

The arrow button right of the preview area opens the Brush Properties dialog.

58Harmony 22 Paint Reference Guide

Property

Description

W hile the Tool Properties view only gives you access to a few of the brushproperties, a list of brush presets and other draw ing options, the Brush Properties
dialog gives you access to all the available options for your brush's tip and texture.
For more information on the Brush Properties dialog, see the Brush Properties Dialog
section below .

Defines the maximum w idth of brush strokes.
Maximum Size

If the tool is used w ith a pressure sensitive pen tablet, the w idth of the stroke w illvary betw een its maximum size and minimum size depending on the amount ofpressure used. If used w ith a mouse, the w idth of the stroke w ill alw ays be its
maximum size.

Allow s you to set the opacity for each instance of the brush tip that gets printed into
your canvas. Contrary to the Opacity parameter, the flow parameter has a cumulative
effect. This means that a low er flow w ill make your brush strokes more transparent
tow ards its extremities and more opaque in its center. Your stroke's flow w ill also
accumulate if you draw over it. By default, your brush's flow varies w ith the amountFlowof pressure you put on your tablet pen.

NOTE
This option is only displayed in the Tool Properties view w hen draw ing on abitmap layer.

The Opacity parameter are w here Lets you set the opacity of your brush strokes.
Contrary to the Flow parameter, the Opacity parameter is non-cumulative. Yourw hole brush stroke's opacity w ill not exceed the Opacity parameter. By default, theOpacity parameter varies depending on the amount of pressure you put on yourtablet pen.
Opacity

NOTEThis option is only displayed in the Tool Properties view w hen draw ing on abitmap layer.

Brush Presets
These options allow you to select, create and manage brush presets.

59

Chapter 2: Tools Properties

Icon

Property

Description

By default, Harmony has preloaded brush presets. You can also create
your ow n brush presets by configuring your brush, then saving its
properties into a new preset. It is also possible to export and importbrush presets.

Presets list

New Brush Preset

Creates a new preset based on the current tool properties.

Delete Brush

Deletes the currently selected preset.

Open a menu that contains the follow ing options:l

New Brush Preset: Creates a new preset based on the current
tool properties.

lDelete Brush: Deletes the currently selected preset.

lRename Brush: Allow s you to rename the currently selected
preset.

lImport Brushes: Allow s you to import brush presets exported
from Harmony.

l

Export Brushes: Allow s you to export your brush presets into
an .xml file.

l

Small Thumbnail: Displays presets in a grid of small
thumbnails w ith a preview of their tip.

lLarge Thumbnail: Displays presets in a grid of big thumbnails,
w ith their name and a preview of their tip.

lStroke View: Displays presets in a list, w ith their name and apreview of a stroke done w ith each preset.

Brush Presets Menu

60

Harmony 22 Paint Reference Guide

Drawing Options
These options affect the w ay your draw ing strokes are added to your artw ork.
Icon

Property

Description

W hen enabled, your brush strokes w ill appear behind the existingartw ork.

Draw Behind

NOTEYour brush stroke w ill temporarily appear over your artw ork as
you draw it, until you release the mouse cursor or tablet pen.

W hen enabled, draw ing a closed shape w ill automatically fill it w ith thecurrently selected Paint colour.

Auto Fill

TIP
By default the pencil line and its fill w ill be the same colour. To
select different colours for the line and its fill, do the follow ing:
1. In the Colour view , click the
2. Click on the

Unlock Three Colours button.

Set Current Brush Colour sw atch. Then, inthe colour list, select the desired colour sw atch for youroutline.
3. Click on the

Set Current Paint Colour sw atch. Then, in thecolour list, select the desired colour sw atch for the fill.

Repaint BrushW hen enabled, your brush strokes w ill only repaint existing artw ork andw ill not add colour to empty areas. If you repaint semi-transparent
artw ork, your artw ork w ill not become more opaque than it already is.

61

Chapter 2: Tools Properties

As you draw in the Line Art layer, the Automatically Create Colour Art
option instantly creates the corresponding strokes in the Colour Art
layer.

Automatically Create
Colour Art

NOTEThis option is only available w hen draw ing on a vector layer.

By default, w hen draw ing on a vector layer, each new stroke is createdas a separate draw ing object, w hich can be edited independently fromother parts of the artw ork. W hen enabled, the Auto-Flatten option
automatically merges strokes into existing artw ork.
Auto-Flatten Mode

NOTE
This option is only available w hen draw ing on a vector layer.
W hen draw ing on a bitmap layer, artw ork is alw ays flattened.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as to selectw hich types of snapping are enabled.

Snapping

If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You can also
click on this button to toggle it off, w hich w ill disable all snapping
modes, and click on it again and toggle it on to re-enable the snapping
modes w hich w ere previously enabled.
This tool supports the follow ing snapping mode:l

Respect Protected
ColourSnap to Alignment Guides: W hile draw ing, the draw ing tool
w ill snap against nearby alignment guides.

In the Colour view , it is possible to make some of the colours in yourpalettes protected from change. W hen enabled, the Respect Protected62Harmony 22 Paint Reference Guide

Colour option w ill prevent the brush tool from draw ing over areas filled
w ith a protected colour.

NOTE
This option is only available w hen draw ing on a vector layer.
W hen draw ing on a bitmap layer, colour is not linked to yourpalettes and cannot be protected.

The Use Stored Colour Gradient option can be used w hen painting w ith
a gradient colour to alw ays position the gradient in the same w ay it w asstored, making it consistent across brush strokes. You can store a
gradient by selecting a zone painted w ith a gradient w ith the Select tool,
Use Stored Colour
Gradient

then clicking on Store Colour Gradientin the Tool Properties view .

NOTEThis option is only available w hen draw ing on a vector layer.

Brush Properties Dialog
Brushes have an extensive set of options and properties that are not displayed in the Tool Properties view , butrather, in a dialog you can access from it. To open the Brush Properties dialog, click on the arrow button rightof the stroke display area.

The Brush Properties dialog has five different tabs, minus the Smoothing tab if you are w orking on a bitmap
layers. Below is detailed information about the options available in each tab:l

Tip Tab on page 63lSmoothing Tab on page 70

lTransparency Tab on page 71lDual Tip Tab on page 75lPaper Texture Tab on page 78

Tip TabThe Tip tab allow s you to configure the shape, size, hardness and spacing of your brush tip.

63

Chapter 2: Tools Properties

NOTE
The "Size Proportional to Camera" option has been moved to the new Size Properties w indow .

Property

Description

Allow s you to select betw een one of the follow ing brush types:lSolid Vector Brush: Creates vector shapes filled w ith a solid colour.
Makes artw ork lightw eight, scalable and easy to tw eak. Since this kind ofbrush can only create solid colour shapes, solid vector brushes have alimited set of options including size, roundness, angle, centerline
smoothing and contour smoothing.

l

Textured Vector Brush: Creates vector shapes filled w ith a texture. This
gives you access to bitmap brush tips, paper textures, transparency andseveral other options.

Brush Type64

Harmony 22 Paint Reference Guide

NOTE
This option is not available w hen w orking on a bitmap layer. W ith bitmap
layers, brushes are alw ays textured, and textured brush options are alw ays
available.

Brush Tip LibraryThis is w here you select the shape of the brush tip. By default it is round. Notethat some tips are designed to have semitransparent areas, even w hen the
maximum brush opacity is set to 100%.
To create a custom brush tip, you must prepare the file ahead of time, either inHarmony or in a third-party softw are, such as Adobe Photoshop. Colour is notsupported and transparency is not supported in the traditional sense. Black
appears as 100% opaque, w hite appears as 100% transparent and all the
shades of grey in betw een appear as varying degrees of semitransparency. A
range of file formats are supported—.jpeg, .png, .tif, .psd, .tga to name a few .
Alpha channels are disregarded on import. It is recommended that your file bebetw een 100 x 100 pixels and 400 x 400 pixels.
You can also import brush tips that you exported from Harmony, so you canshare them w ith colleagues.

The minimum and maximum sizes of your draw ing tool produce the thick andthin effect on your stroke. This w orks w ith the pressure sensitivity of a pen tablet.
l

Maximum Size: Defines the maximum w idth of the stroke.

l

Minimum Size: Defines the minimum w idth of the stroke in relation toand as a percentage of the maximum size.

Minimum and Maximum Size
You can control the size properties by clicking on the arrow button on right andthe dialog box w ill appear as show n below .

65Chapter 2: Tools PropertieslPressure: Allow s you to apply more pressure and increases the size ofthe brush. You can check the box to invert this behaviour.

l

Tilt: Allow s you to tilt the pen closer to tablet for a bigger stroke. You cancheck the box to invert this behaviour.

l

Speed: Allow s you to reduce the size of the stroke by draw ing at a fast
speed. You can check the box to invert this behaviour.

l

Speed Sensitivity: A slider is used to control how fast must the stroke bedraw n to reach the minimum value.

lTaper: Allow s you to reduce the value of a property at the start or theend of each stroke. The value can be expressed using tw o options:Distance and Percentage. Distance is selected by default. For example:
A taper of 200 w ill be the same length as the w idth (diameter) of a strokethat has its size set at 200.

You can enable Start and End Tapering option individually.
lStart Taper: W hen distance is selected as a Taper value, the effect ofstart taper can be visualized as the stroke is draw n.

l

End Taper: W hen distance or percentage is selected as a Taper value,
the effect of end taper can be visualized once the stroke is complete andvectorized as the length is unknow n until the stroke is complete.

l

Fade Distance: Allow s you to fade the value of property over a given
distance. It uses the same units as the size and is applied as the stroke isdraw n.

lSize Proportional to Camera: If you check this option, the size of the w ill
be adjusted to the position of the camera on the z-axis. This means that if

66

Harmony 22 Paint Reference Guide

the camera is zoomed in on the scene, the w ill be proportionally smaller
so that it appears the same size in the rendered image. Likew ise, if thecamera is zoomed out, the w ill be proportionally bigger.

NOTE
Setting the Minimum Size value to 100% eliminates the possibility ofcreating w idth variation on your stroke. In other w ords, you w ould be
forcing a uniform line w idth using the Maximum Size value.

The Roundness and Angle parameters allow you to change the shape andorientation of the tip.

Roundness and AnglelRoundness: The vertical scaling to apply to the tip. Reducing this setting
squashes the tip vertically, allow ing you to turn round or square tips into
flat tips.

lAngle: The angle at w hich to rotate the brush tip, counterclockw ise.

NOTE
The squashing is not relative to the angle—if the tip is rotated, thesquashing w ill still be done relative to the tip's original orientation.

If your pen and tablet support tilt sensitivity, this option allow s you to set
w hether your brush takes your pen's tilt angle into account, and how much.

Pen Tilt Sensitivity

W hen your pen is fully tilted, your brush tip w ill be stretched by the percentage
you set in this parameter, in the angle in w hich you tilt it. For example, if you set
the Pen Tilt Sensitivity to 50%, and you tilt your pen all the w ay up or dow n, yourbrush tip w ill be stretched vertically by 50%. W ith the same setting, if you tilt
your pen all the w ay left or right, your brush tip w ill be stretched horizontally by
50%.

67

Chapter 2: Tools Properties

If enabled, your brush tip w ill rotate w ith the angle of your pen tip. You can selectone of the follow ing options:Angle FunctionlConstant: The static orientation of the brush tip expressed in degrees.

lHeading: The orientation of the brush tip is determined by the direction in
w hich the stroke is draw n. It changes dynamically as the stroke is draw n.

lAzimuth: W hen the pen is tilted, it uses the direction in w hich the pen
eraser is facing.

lTwist (if supported by pen): It uses the tw ist angle of the stylus and is
only available w ith W acom Art Pen.

The hardness value corresponds to the softness of the brush tip's edges. The
low er the value, the softer the tip edge. The higher the value, the sharper the tipedge. Be aw are that some brush tips are not 100% opaque, so they w ill alw ays
appear somew hat soft, even at 100% hardness.
Hardness

Spacing

Defines the amount of space betw een each stamp of the brush. A value of 100%
sets the stamp marks edge to edge, if there is no w hite space around the shape.
The larger the value, the greater the space betw een marks. A really large value
can make the brush stroke appear as a string of individual marks. Conversely, asmall spacing value w ill give the appearance of a fluid brush stroke.
Spacing is only evident w hen making a continuous stroke.

68Harmony 22 Paint Reference Guide

You can create variation betw een the thick and thin of your brush stroke just by
setting the Maximum and Minimum Size values. If you add randomness to themix, pressure sensitivity from your draw ing tablet w ill still be applied. Lightpressure w ill create random values around the minimum, w hile heavy pressure
w ill create random values closer to the maximum. The larger the percentage, thelarger the range of random variation.

Random Size

NOTE
Setting the Minimum Size to 100% eliminates the possibility of creating
w idth variation on your stroke, w hether you are applying randomness ornot. Therefore, you w ould be forcing a uniform line w idth using theMaximum Size value.

Random Angle

Sets the range for random rotation around the set Angle value. For example, if
the Angle is set to 45° and the Random Angle set to 10°, the softw are w illchoose values betw een 40°–50° (plus or minus 5 degrees, equaling a total of 10
degrees).

69

Chapter 2: Tools Properties

Sets the range for random spacing around the set Spacing value. For example, if
the Spacing is set to 50% and the Random Spacing is set to 10%, then Harmony
w ill choose values betw een 45%–55% (plus or minus 5 percent, equaling a totalof 10 percent).

Random Spacing

Smoothing Tab
The Smoothing tab contains options to configure how Harmony should automatically smooth your brushstrokes as you paint.

70

Harmony 22 Paint Reference Guide

NOTE
The Smoothing tab is only available w hen w orking on a vector layer, as bitmap layers do notsupport smoothing.

Property

Description

Centerline Smoothing

Defines the amount of smoothing Harmony should perform on the central line of thebrush stroke. A higher setting w ill prevent your line from being shaky, but is liable toreduce draw ing precision and turn sharp angles into curves.

Contour Smoothing

Defines the amount of smoothing Harmony should perform on the outer contour ofthe brush stroke. A higher setting w ill round sharp corners and reduce the amount ofcontrol points for the resulting vector shape.

Transparency Tab
The Transparency tab allow s you to decide if your brush has antialiasing as w ell as to set its flow and opacity
settings.

71

Chapter 2: Tools PropertiesNOTE
The Transparency tab's options are only available on vector layers if the Brush Type option of the
Tip tab is set to Textured Vector Brush. On bitmap layers, those options are alw ays available.

Property

Description

Enabled by default. This option causes the contours of the brush strokes to blend
w ith the surrounding colours, to create an illusion of smoothness otherw ise notpossible due to the picture resolution.

Antialiasing

If antialiasing is disabled, the brush's texture w ill only render fully transparent or
fully opaque pixels. Disabling this option can be useful if you need your outlines
to be very crisp, if you w ant to make pixel art or if you need your brush strokes torender in solid colors w ith no variation, w hich makes them easier to repaint orprocess in third party softw are.

NOTE
W hen disabled, all other options in the Transparency tab are disabled.

The Maximum and Minimum Flow parameters let you set the range for the rate
at w hich paint flow s from your brush. The analogy w orks better w ith a pen. The
greater the flow , the more ink comes out, hence the more consistent the colour
and texture of the line. If the flow is light, then the colour and texture of the line
may look spotty. This feature w orks w ith the pressure sensitivity of a pen tablet.

Maximum and Minimum FlowlMaximum Flow: Sets the maximum rate at w hich colour and texture areapplied as you create a fluid stroke.

l

Minimum Flow: Sets the minimum rate at w hich colour and texture areapplied as you create a fluid stroke. It is defined as a percentage of theMaximum Flow value. If the Minimum Flow value is set to 100%, thentablet pressure sensitivity w ill no longer be applicable. The flow w ill be
set to the constant rate of the Maximum Flow value.

You can control the flow properties by clicking on the arrow button on right andthe dialog box w ill appear same as show n for size properties above. Minimum

72Harmony 22 Paint Reference Guide

and Maximum Size on page 65.

The Maximum and Minimum Opacity parameters are w here you set the opacity
range for a brush mark. This w orks w ith the pressure sensitivity of a pen tablet.
l

Maximum Opacity: Sets the transparency limit of the brush mark w hen
the pressure is heavy.

lMinimum Opacity: Sets the transparency limit of the brush mark w hen
the pressure is very light. It is defined as a percentage of the Maximum
Opacity value. If the Minimum Opacity value is set to 100%, then tablet
pressure sensitivity w ill no longer be applicable. The opacity w ill be set
to the constant rate of the Maximum Opacity value.

Maximum Opacity and
Minimum Opacity

You can control the opacity properties by clicking on the arrow button on rightand the dialog box w ill appear same as show n for size properties above. Pleaserefer Minimum and Maximum Size on page 65

RandomnessTh Randomness parameter lets you set the range for the randomness of the flow
and opacity. This w orks w ith the pressure sensitivity of a pen tablet.

Randomness Flow

You can create variation in the flow of your brush stroke just by setting theMaximum and Minimum Flow values. If you add randomness to the mix, pressure
sensitivity from your draw ing tablet w ill still be applied. Light pressure w illcreate random values around the minimum, w hile heavy pressure w ill create
random values closer to the maximum. The larger the percentage, the larger therange of random variation.

73

Chapter 2: Tools Properties

NOTE
Setting the Minimum Flow value to 100% eliminates the possibility ofcreating flow variation on your stroke, w hether you are applying
randomness or not. That is, you w ould be forcing a uniform flow using theMaximum Flow value.

You can create variation in the opacity of your brush stroke just by setting theMaximum and Minimum Opacity values. If you add randomness to the mix,pressure sensitivity from your draw ing tablet w ill still be applied. Light pressure
w ill create random values around the minimum, w hile heavy pressure w ill create
random values closer to the maximum. The larger the percentage, the larger therange of random variation.

Random Opacity74Harmony 22 Paint Reference Guide

NOTE
Setting the Minimum Opacity value to 100% eliminates the possibility ofcreating opacity variation on your stroke, w hether you are applying
randomness or not. That is, you w ould be forcing a uniform opacity using
the Maximum Opacity value.

Dual Tip Tab
The Dual Tip tab lets you set the parameters for creating a dual tip brush. The primary bitmap brush tip andthe dual tip alw ays w ork together. You can set the parameters for the primary tip in the Tip tab and those forthe dual tip in the Dual Tip tab. The Blend mode you select determines how the tips are combined.
By default, the Blend Mode is set to Multiply and the Random Angle to 360°.

75

Chapter 2: Tools Properties

NOTE
To use a Dual Tip, you must enable option by checking the checkbox inside the Dual Tip tab.
Additionally, if you are w orking on a vector layer, the Brush Type option of the Tip tab must be set
to Textured Vector Brush.

Property

Description

The checkbox inside the tab allow s you to decide w hether or not your brush uses a
Enable/Disable

dual tip. If this checkbox is unchecked, the options in the Dual Tip tab w ill bedisabled.

Blend Mode

The Blend modes let you decide how the primary tip and the dual tip are combined.

This is the default blend mode. W hen the tw o brush tips are combined in this mode,
they essentially cut each other out in overlapping areas, w here one or both tips havean area of 100% transparency. The less opaque the brush tips are, the lighter their
combination.

Multiply

Colour Dodge

In this mode, the primary tip cuts out the shape of the dual tip. W here the tip shapes
overlap, w ithin the boundaries of the primary shape, the colour and opacity appear
darker.

76

Harmony 22 Paint Reference Guide

Property

CombineDescription

This mode treats the tw o tips as tw o different and separate brushes that have thesame colour and follow the same path.

77

Chapter 2: Tools Properties

Property

Description

Paper Texture Tab
The Paper Texture tab lets you configure a paper-like texture for your brush. You can also add textures byimporting image files, or import paper textures that w ere previously exported from Harmony.

78Harmony 22 Paint Reference Guide

NOTE
To use a Paper Texture, you must enable option by checking the checkbox inside the Paper
Texture tab. Additionally, if you are w orking on a vector layer, the Brush Type option of the Tip
tab must be set to Textured Vector Brush.

Property

Description

Enable/Disable

The checkbox inside the tab allow s you to decide w hether or not your brush uses apaper texture. If this checkbox is unchecked, the options in the Paper Texture tab w ill
be disabled.

Texture Scale

Increase or decreases the size of the paper texture.

Additive

This option layers the texture on top of itself as you scribble overlapping lines in one
continuous stroke. If this option is turned off, areas of overlapping lines from a single,
continuous stroke w ill appear the same, in terms of darkness and texture, as non-79

Chapter 2: Tools Properties

Property

Description

overlapping areas.

This option defines the w ay separate, overlapping strokes behave. If this option isenabled, the paper texture's position does not change w ith each sw eep of the brush.
If this option is disabled, each sw eep of the brush produces a different texture
position. The texture orientation alw ays stays the same.

Aligned80

Harmony 22 Paint Reference Guide

Centerline Editor Tool Properties
The Centerline Editor tool allow s you to edit brush strokes by their centreline rather than by their contour. This
makes it easier to tw eak the tips, curves and corners of brush strokes. The purpose of this tool is to make it aseasy to edit brush strokes as it is to edit pencil lines w ith the Contour Editor tool.

How to access the Centerline Editor tool properties
1. In the Tools toolbar, select the Centerline Editor

tool.

2. The tool's properties are displayed in the Tool Properties view .

Tool Options
Icon

Property

Description

Allow s you to choose the method to visually select multiple
elements:lLasso: Allow s you to select multiple elements bydraw ing an irregular closed shape around them w ith
your mouse.

lMarquee: Allow s you to select multiple elements
by draw ing a rectangle around them. This is faster, as
you only need to drag your mouse from one corner ofthe rectangle to its opposite corner, but it may not be as
precise as you w ant.

Selection ModeTIP
You can press and hold the Alt key to temporarily use
the other selection mode.

Show Centerline Editor Controls

W hen enabled, selecting several control points w ill make amanipulator bounding box appear. You can use thismanipulator to scale and rotate the selection of points.

81

Chapter 2: Tools Properties

Icon

Property

Description

Allow s you to perform draw ing operations on both the Line Art
and Colour Art layers of your draw ing simultaneously.
Apply to Line and Colour Art

NOTE
If you have Overlay and Underlay Art layers enabled,
they w ill also be affected w hen this option is enabled.

Centerline Smoothness

Allow s you to adjust the amount of control points on thecentreline that is generated from the selected stroke. A low ervalue w ill create a centreline w ith less points, w hich makes it
easier to manipulate large lengths of the stroke, and a higher
value w ill generate a centreline w ith more points, allow ing you
to tw eak details.

82Harmony 22 Paint Reference Guide

Close Gap Tool Properties
The paint tool requires the area you attempt to fill to be closed in order to know exactly w hat area of yourartw ork must be filled. How ever, it is common for artists to accidentally leave small gaps in their artw ork.
The Close Gap tool allow s you to quickly close small gaps in a shape by creating an invisible stroke connecting
tw o extremities of the gap. You can then fill the area using the Paint tool, as this invisible stroke w ill be takenin account to determine the outline of the shape to fill.

TIP
You do not need to use the Close Gap tool w ith precision. If you draw a crude stroke near the gap
you w ant to close, the tool w ill automatically detect the tw o closest line extremities and w ill draw
an invisible straight line connecting them. closing the gap betw een them.

How to access the Close Gap tool properties
1. In the Tools toolbar, select the Close Gap

tool.

The tool's properties are displayed in the Tool Properties view .

Tool Options
Icon

Property

Description

The Close Gap tool creates an invisible draw ing stroke to close the shape.
Enabling this option w ill merge the stroke into the artw ork instead of adding thestroke on top of it.
Auto Flatten

NOTE
The area you close w ith the Close Gap tool w ill be fillable regardless ofw hether or not this option is enabled.

83

Chapter 2: Tools Properties

Colour Eyedropper Tool Properties
The Colour Eyedropper tool allow s you to pick a colour from your draw ing w ithout going to the Colour view .

NOTE
The follow ing options w ill only have an effect w hen picking colours from a bitmap layer, as theyaffect the colour that gets picked. W hen w orking on a vector layer, you can only pick colours thatare available in one of the palettes in your scene. Therefore, the colour you pick w ill alw ays be
exactly the colour that w as used to fill the shape or stroke you clicked on.

How to access the Colour Eyedropper tool properties
1. In the Tools toolbar, select the Colour Eyedroppertool.

The tool's properties are displayed in the Tool Properties view .

Icon

Property

Description

Sample All Layers

By default, the Colour Eyedropper tool picks the colour from the active
draw ing layer only. This means that if the colour is semi-transparent, it w ill
still only take the colour from the active layer, along w ith its transparency,
and ignore the colours from layers behind it.
W ith this option enabled, the Colour Eyedropper tool w ill pick the colour as
it appears on the screen instead, allow ing you to pick colours that are theresult of several layers composited together.

Do Not Pick
Transparency

By default, the Colour Eyedroppertool picks the colour's alpha value as w ell
as its colour values. W hen enabled, the colour picked w ill alw ays have analpha value of 255.

84

Harmony 22 Paint Reference Guide

Contour Editor Tool Properties
The Contour Editor lets you reshape vector shapes, brush strokes and lines in your draw ings.
Artw ork in Harmony is made of vector shapes. Vector shapes are defined by points, the lines joining the points
together (contours) and the curve vectors, represented by Bezier handles, w hich make the curve of said lines.

The Contour Editor tool allow s you to select a contour or point, and change the position of points, add andremove points from the shape, rotate, lengthen and shorten curve handles to influence the curve of contours
betw een those points, or drag contours betw een points to change their curve directly.

How to access the Contour Editor tool properties
1. In the Tools toolbar, select the Contour Editor

tool.

The tool's properties are displayed in the Tool Properties view .

Tool Modes
Icon

Property

Description

Allow s you to choose the method to visually select multiple
elements:l

Selection Mode

Lasso: Allow s you to select multiple elements bydraw ing an irregular closed shape around them w ith yourmouse.

lMarquee: Allow s you to select multiple elements by85

Chapter 2: Tools Properties

Icon

Property

Description

draw ing a rectangle around them. This is faster, as you only
need to drag your mouse from one corner of the rectangle toits opposite corner, but it may not be as precise as you w ant.

TIP
You can press and hold the Alt key to temporarily use theother selection mode.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as toselect w hich types of snapping are enabled.
If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You canalso click on this button to toggle it off, w hich w ill disable allsnapping modes, and click on it again and toggle it on to re-enable
the snapping modes w hich w ere previously enabled.
This tool supports the follow ing snapping modes:lSnap to Contour: W hen enabled, moving the control point
in a contour near another contour w ill snap that control
point against that contour. This w ill lock the point and thecontour together, and moving the control point w ill deformthe contour.

Snapping

This option can be especially useful if you need to makes theedges of tw o shapes snap together, like so:

You can also use this option to make a control point snap
against another control point, allow ing you to join lines
together.

86Harmony 22 Paint Reference Guide

Icon

Property

Description

NOTE
W hen a control point is snapped against a contour
or another control point in your draw ing, the Contour
Editor w ill manipulate them together. How ever,even if you make a point in one draw ing stroke snap
against another draw ing stroke, they w ill remain
separate draw ing strokes unless they are flattened
together, and you w ill still be able to manipulatethem individually w ith the Select

tool.

l

Snap to Alignment Guides: W hile moving the selection or
one of its control points, it w ill snap against nearbyalignment guides.

lSnap and Align: Snaps the selected anchor point to any
existing line w hile displaying temporary rulers as a guidethat you can also snap your anchor point to.

lSnap to Grid: W hile moving the selection, the mouse cursor
w ill snap against the intersecting points of the grid.

TIP
To display the grid, select View > Grid > Show Gridfrom the top menu or press Ctrl + '.

W hen enabled, selecting several control points w ill make amanipulator bounding box appear. You can use this manipulator toscale and rotate the selection of points.
Show Contour Editor
Controls

Tip StyleIf you select and remove part of a pencil line, this option allow s you
to choose w hich kind of line tip the removed segment should leavebehind:87

Chapter 2: Tools Properties

Icon

Property

Description

Tip Style: Round: Leaves rounded tips at the extremities

lof the deleted line segment.

Tip Style: Flat: Leaves flat tips at the extremities of theldeleted line segment.

Allow s you to perform draw ing operations on both the Line Art andColour Art layers of your draw ing simultaneously.
Apply to Line and Colour
Art

NOTE
If you have Overlay and Underlay Art layers enabled, theyw ill also be affected w hen this option is enabled.

Operations
Icon

Property

Description

The Smooth operation lets you smooth out selected draw ing
strokes and remove extra points.

Smooth Selection

TIP
You can also smooth the selection by selecting Selected >Smooth from the top menu or by pressing Alt + Shift + S.

Split Pencil LineW hen draw ing w ith the Polyline tool, your draw ing has an even line
thickness. You can use the Pencil Editor to adjust the thickness point88Harmony 22 Paint Reference Guide

Icon

Property

Description

by point, but if you w ant to adjust it quicker, you can use the Split
Pencil Line and Point Pencil Lines options to create segments andapply a pencil stencil to your draw ing. Note that if you did not join
the pencil lines on your polyline stroke, the segments betw een the
points w ill act as separated segments.

Join Pencil Lines

89

Chapter 2: Tools Properties

Cutter Tool Properties
The Cutter tool lets you cut out part of a draw ing so that you can transform it, copy it or delete it. It also allow s
you to trim overshot lines.

How to access the Cutter tool properties
1. In the Tools toolbar, click and hold on the Selectthe Cutter

tool to display the menu beneath and selecttool.

The tool's properties are displayed in the Tool Properties view .

Tool Options
Icon

Property

Description

Allow s you to choose the method to visually select multiple elements:lLasso: Allow s you to select multiple elements by draw ing anirregular closed shape around them w ith your mouse.

lSelection Mode

Marquee: Allow s you to select multiple elements by draw ing a
rectangle around them. This is faster, as you only need to drag yourmouse from one corner of the rectangle to its opposite corner, but it
may not be as precise as you w ant.

TIP
You can press and hold the Alt key to temporarily use the otherselection mode.

Easy Drag

W hen enabled, you can drag the selection by clicking anyw here inside its
bounding box. By default, you must click on the artw ork in the selection to beable to drag it.

90Harmony 22 Paint Reference Guide

Icon

Property

Description

W hen this option is enabled along w ith the Lasso

selection type, quickly

draw ing a line w ith the Cutter tool over a line segment in your artw ork w ill
instantly delete it. This can be useful if you w ant to use the Cutter tool toquickly clean up your artw ork.

Use Mouse
GestureIt allow s you to cut in tw o modes as follow s:lSingle Line Cutting Gesture: It deletes first line segment over w hicha straight gesture is draw n w ith the cutter.

lMultiple Lines Cutting Gesture: It deletes all line segments overw hich a straight gesture is draw n w ith the cutter.

NOTE
This option w ill only w ork w hen using the Cutter tool on separate
brush or pencil strokes. Hence, it is important not to flatten yourartw ork if you intend to use this option to clean up your draw ings. This
option has no effect on bitmap layers as the artw ork in bitmap layers is
alw ays flattened.

Use Mouse
Gesture BreakerMode

W hen using the Lasso selection type, the Use Mouse Gesture Breaker Mode
option lets you draw an invisible stroke on a pencil line to cut it in tw oindividual objects. Once a pencil line is cut w ith this option, you w ill be able
to select the tw o portions independently w ith either the Cutter tool, Pencil
Editor tool or Select tool.

91

Chapter 2: Tools Properties

Icon

Property

Description

NOTE
This option only w orks w ith pencil lines.

W hen cutting through pencil lines, this option decides w hat kind of pencil
line tips to put at the extremities of the remaining pencil line segments,
w here they w ere cut.

By default, this is set to Bevel, w hich w ill leave the tip of the pencil line

cut at the same angle as your cutter stroke. If you prefer, you can make pencil
lines that you split w ith the Cutter tool have Flat

or Roundtips

instead.
Tip StyleW hen w orking on bitmap artw ork, enabling this w ill smooth the edges of theartw ork you cut out, so that they do not appear pixelated.
Antialiasing

NOTE
This option is only available w ith bitmap layers.

Apply to Visible
Draw ing Layers

This option allow s you to select w hich layers the tool should affect. It can be
toggled on or off. W hen toggled on, it has tw o different modes. You canselect a mode by clicking and holding on the button.

92

Harmony 22 Paint Reference Guide

Icon

Property

Descriptionl

Off: W hen this button is toggled off, the tool only w orks on thecurrently selected layers. If several layers are selected, the tool w ill
w ork on all these layers simultaneously.

l

On W hen this button is toggled on, the tool w ill w ork on all thevisible layers.

l

Apply to Visible Drawing Layers: The tool w ill w ork on all thevisible layers in the Camera view .

lApply to Synced Drawing Layers: If the currently selected layer
is synced w ith another layer, the tool w ill w ork on both the current
layer and its synced layer.

NOTE
This option only w orks in the Camera view .

This option allow s you to determine w hich draw ings in the current layer the
tool should affect. It can be toggled on or off. W hen toggled on, it has tw odifferent modes. You can select a mode by clicking and holding on the button.
l

Apply to All
Frames

Off: W hen this button is toggled off, the tool only w orks on thedraw ing in the current frame.

lApply to All Frames: The tool w ill w ork on every exposeddraw ing in the selected layer simultaneously.

lApply to Onion Skin Range: The tool w ill w ork on every draw ing
displayed in the Onion Skin. Onion Skin must be enabled for thisoption to w ork.

Allow s you to perform draw ing operations on both the Line Art and Colour
Art layers of your draw ing simultaneously.
Apply to Line andColour Art

NOTE
If you have Overlay and Underlay Art layers enabled, they w ill also beaffected w hen this option is enabled.

Operations
Icon

Property

Description

93

Chapter 2: Tools Properties

Flip Horizontal

Flips the current selection horizontally.

Flip Vertical

Flips the current selection vertically.

Rotate 90 Degrees
CW

Rotates the current selection 90 degrees clockw ise.

Rotate 90 Degrees
CCW

Rotates the current selection 90 degrees counter-clockw ise.

94Harmony 22 Paint Reference Guide

Drawing Pivot Tool Properties
The Draw ing Pivot tool lets you set the pivots on your character. You can set the draw ing pivots on draw ings
and symbols.

Tool Options
Icon

Property

Description

The Set the Pivot for Symbol on All Frames option
is enabled by default. W hen you set a draw ing
pivot on a symbol, all of its cells use the samedraw ing pivot. This means you do not have to set adraw ing pivot on all frames. Once you set it, it isdone.
If you prefer to set a different draw ing pivot for aseries of cells, you can deselect the option and set
your pivots on each cell or cell range.

Setting the Draw ing Pivot for Symbols on
All Frames

NOTE
If you have already set several different
pivots on your symbol's cells and selected
the Set the Pivot for Symbol on All
Frames option, once you set a new pivoton the same symbol, all of its pivots w ill
be reset and w ill use your new pivot.

Allow s you to enable or disable snapping for thistool and all other animation and draw ing tools that
support snapping, as w ell as to select w hich typesof snapping are enabled.
Snapping

If you double-click or long-click on this button, it
w ill open a pop-up menu in w hich you can toggle
different snapping modes. You can also click on
this button to toggle it off, w hich w ill disable allsnapping modes, and click on it again and toggle it95

Chapter 2: Tools Properties

Icon

Property

Description

on to re-enable the snapping modes w hich w ere
previously enabled.
This tool supports the follow ing snapping modes :lSnap to Contour: W hen moving the pivot,
it w ill snap against the nearby points andcontours of your artw ork.

lSnap to Alignment Guides: W hen moving
the pivot, it w ill snap against nearbyalignment guides.

lSnap and Align: W hen moving the pivot, it
w ill align w ith the edges of elements in thedraw ing.

lSnap to Grid: W hen moving the pivot, it
w ill snap against the intersecting points ofthe grid.

TIP
To display the grid, select View >Grid > Show Grid from the top
menu or press Ctrl + '.

Reset Pivot

W hen you click the Reset Pivot option, the draw ing
pivot of the selected draw ing or symbol is reset tothe centre of the Camera view .

Copying Pivot on Parent Symbol

W hen you import new extra draw ings, such as
hands and mouths, you can use the draw ing pivotthat w as set on your draw ings and report them tothe symbol's cells. Use the Copy Pivot to Parent
Symbol command for this.

96Harmony 22 Paint Reference Guide

Icon

Property

Description

NOTE
W hen you copy draw ing pivots to theparent symbol, there is no link betw een
the draw ings' pivots and the symbol's
pivots. If you modify the draw ing pivot
later, it w ill not link to the symbol. You
w ould need to perform the operation
again. If you need to modify the symbol's
pivots, you can do it directly on thesymbol's cells.

97Chapter 2: Tools Properties

Edit Gradient/Texture Tool Properties
The Edit/Gradient Texture tool allow s you to move, rotate and scale a gradient or texture fill w ithin the shapeit fills, w ithout modifying the shape itself.

How to access the Edit Gradient/Texture tool properties
1. In the Tools toolbar, select the Edit Gradient/Texture

tool.

The tool's properties are displayed in the Tool Properties view .

Tool Options
Icon

Property

Description

This option allow s you to select w hich layers the tool should affect. It can be
toggled on or off. W hen toggled on, it has tw o different modes. You canselect a mode by clicking and holding on the button.

Apply to Visible
Draw ing LayerslOff: W hen this button is toggled off, the tool only w orks on thecurrently selected layers. If several layers are selected, the tool w ill
w ork on all these layers simultaneously.

l

On W hen this button is toggled on, the tool w ill w ork on all thevisible layers.

l

Apply to Visible Drawing Layers: The tool w ill w ork on all thevisible layers in the Camera view .

lApply to Synced Drawing Layers: If the currently selected layer
is synced w ith another layer, the tool w ill w ork on both the current
layer and its synced layer.

NOTE
This option only w orks in the Camera view .

98

Harmony 22 Paint Reference Guide

Ellipse Tool Properties
The Ellipse tool allow s you to quickly draw an ellipse or a circle.

How to access the Ellipse tool properties
1. In the Tools toolbar, select the Ellipse

tool.

The tool's properties are displayed in the Tool Properties view .

Pencil Properties
Just like other shape tools, this tool creates pencil lines. Hence, its tool properties are similar to the ones of thePencil tool and it can be used w ith pencil presets.

99

Chapter 2: Tools Properties

Property

Description

The Preview area lets you see a preview of the stroke your draw ing tool w ill make.
Preview Area

The arrow button right of the preview area opens the Pencil Properties dialog.

Pencil Properties
DialogSize

W hile the Tool Properties view only gives you access to a few of the pencil properties,
a list of pencil presets and other draw ing options, the Pencil Properties dialog gives youaccess to all the available options for your pencil's shape and texture. For more
information on the Pencil Properties dialog, see the Pencil Properties Dialog on page
104 section below .

Defines the w idth of the pencil line used to draw the shape.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew . You
can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You can choose
betw een Round, Mitre and Bevel style.

Pencil Presets
These options allow you to select, create and manage pencil presets.

100

Harmony 22 Paint Reference Guide

Icon

Property

Description

Harmony provides a variety of pencil presets and thickness stencils andalso lets you create and save your ow n. It is a good idea to create andsave pencils w ith precise sizes and parameters w hen you draw for
efficiency and consistency.

Presets list

A thickness stencil saves the thickness information across the length ofthe line. W hen draw ing w ith a thickness stencil, the pressure sensitivityof the tablet is discarded. A thickness stencil can be used w hile draw ing,
or applied afterw ards.
You also have the possibility to apply different textures to your lines byeither using the default presets or to import your ow n.
You can export the pencil presets that you have created and importthose that others have created. This is a good w ay for you and project
collaborators to keep a consistent look for the project.

New Brush Preset

Creates a new preset based on the current tool properties.

Delete Brush Preset

Deletes the currently selected preset.

Open a menu that contains the follow ing options:l

New Brush Preset: Creates a new preset based on the current
tool properties.

lDelete Brush: Deletes the currently selected preset.

lRename Brush: Allow s you to rename the currently selected
preset.

lImport Brushes: Allow s you to import brush presets exported
from Harmony.

l

Export Brushes: Allow s you to export your brush presets into an.xml file.

l

Small Thumbnail: Displays presets in a grid of small thumbnails
w ith a preview of their tip.

lLarge Thumbnail: Displays presets in a grid of big thumbnails,
w ith their name and a preview of their tip.

lStroke View: Displays presets in a list, w ith their name and apreview of a stroke done w ith each preset.

Brush Presets Menu

Drawing Options
These options affect the w ay your shape is added to your artw ork.

101

Chapter 2: Tools Properties

Icon

Property

Description

W hen enabled, your brush strokes w ill appear behind the existingartw ork.

Draw Behind

NOTEYour brush stroke w ill temporarily appear over your artw ork as
you draw it, until you release the mouse cursor or tablet pen.

W hen enabled, the shape you draw is automatically filled w ith theselected colour. By default, draw ing a shape only creates its outlines.

Auto Fill

TIP
By default the pencil line and its fill w ill be the same colour. To
select different colours for the line and its fill, do the follow ing:
1. In the Colour view , click the
2. Click on the

Unlock Three Colours button.

Set Current Pencil Colour sw atch. Then, inthe colour list, select the desired colour sw atch for youroutline.
3. Click on the

Set Current Paint Colour sw atch. Then, in thecolour list, select the desired colour sw atch for the fill.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as to selectw hich types of snapping are enabled.
Snapping

If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You can also
click on this button to toggle it off, w hich w ill disable all snapping
modes, and click on it again and toggle it on to re-enable the snapping102Harmony 22 Paint Reference Guide

Icon

Property

Description

modes w hich w ere previously enabled.
This tool supports the follow ing snapping modes:lSnap to Contour: W hen enabled, w hile you're draw ing, themouse cursor w ill snap to the nearby contours of the artw ork inyour draw ing.

lSnap to Alignment Guides: W hile draw ing, the draw ing tool
w ill snap against nearby alignment guides.

lSnap and Align: W hen enabled, w hile you're draw ing, themouse cursor w ill automatically align to the rectangularbounding boxes of other strokes and shapes in your draw ing.

lSnap to Grid: W hile moving the selection, the mouse cursor w ill
snap against the intersecting points of the grid.

TIP
To display the grid, select View > Grid > Show Grid fromthe top menu or press Ctrl + '.

As you draw in the Line Art layer, the Automatically Create Colour Art
option instantly creates the corresponding strokes in the Colour Art
layer.
Automatically Create
Colour Art

By default, w hen draw ing on a vector layer, each new stroke is createdas a separate draw ing object, w hich can be edited independently fromother parts of the artw ork. W hen enabled, the Auto-Flatten option
automatically merges strokes into existing artw ork.
Auto Flatten Mode103

Chapter 2: Tools Properties

Icon

Property

Description

NOTE
Using the Select tool, you can use select and remove a segment offlattened pencil lines. Overlapping pencil lines draw n w ith theAuto-Flatten mode are essentially cut into segments by theoverlap and can be treated as individual lines.

Use Stored Colour
Gradient

The Use Stored Colour Gradient option can be used w hen painting w ith
a gradient colour to alw ays position the gradient in the same w ay it w asstored, making it consistent across brush strokes. You can store a
gradient by selecting a zone painted w ith a gradient w ith the Select tool,
then clicking on Store Colour Gradientin the Tool Properties view .

W hen enabled, the ellipsis tool w ill alw ays draw an ellipsis of equal
w idth and height, making it a perfect circle.
Draw Circle

TIP
You can also draw a perfect circle by holding the Shift key w hiledraw ing.

Pencil Properties Dialog
The Ellipse tool draw s the same type of line as the Pencil tool. Hence, you can configure the Ellipse tool's lines
using the Pencil Properties dialog, w hich you can open by clicking on the arrow button right of the stroke
display area in the Tool Properties view .

Size and Smoothness Tab
The Size and Smoothness tab allow s you to select your pencil's size, its smoothing parameters as w ell as theshape of its tips and corners.

104Harmony 22 Paint Reference Guide

Property

Description

Maximum Size

Defines the maximum size of the pencil line. If the tool is used w ith a pressure
sensitive pen tablet, the w idth of the stroke w ill vary betw een its maximum size andminimum size depending on the amount of pressure used. If used w ith a mouse, thew idth of the stroke w ill alw ays be its maximum size.

Minimum Size

Defines the minimum size of your stroke as a percentage of the maximum size. If you
do not have pressure sensitivity from a pen table, the minimum size value w ill beignored.

Proportional to Camera

If you check this option, the size of the pencil w ill be adjusted to the position of thecamera on the z-axis. This means that if the camera is zoomed in on the scene, thepencil w ill be proportionally smaller so that it appears the same size in the rendered
image. Likew ise, if the camera is zoomed out, the pencil w ill be proportionally bigger.

Centerline Smoothing

Defines the amount of smoothing Harmony should perform on the central line of thepencil stroke. A higher setting w ill prevent your line from being shaky and w ill reduce
the amount of control points it has, making it easier to tw eak, but is liable to reducedraw ing precision and turn sharp angles into curves.

Defines the amount of smoothing Harmony should perform on the outer contour ofthe pencil stroke.

Contour Smoothing

A pencil line is defined by its centreline and its variations in thickness, rather than its
apparent shape. W hen draw ing a pencil line w ith a mouse, its thickness is uniform.
Therefore, its outer contour does not have any control point, except at its extremities,
and no smoothing is required for its contour.
How ever, w hen draw ing a pencil line w ith a pressure sensitive tablet, its contour w ill
have control points and Bezier curves to define the line's variations in thickness, and105

Chapter 2: Tools Properties

Property

Description

thus smoothing must be performed on its contour. An increased contour smoothing
w ill reduce the amount of control points on the line's thickness and smoothen its
curves, but may affect the precision of the variations in line thickness.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew .
You can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You canchoose betw een Round, Mitre and Bevel style.

Texture Tab
In the Pencil Properties view , the Texture tab allow s you to select a pencil texture from the currently selected
pencil texture palette to use w ith the Pencil tool. You can also add, remove or rename textures, save thecurrent pencil texture palette as the default one, or import the pencil texture palette into your scene.
The pencil texture palette used in the Texture tab of the Pencil Properties dialog is the one selected in the
Colour view . You can select a pencil texture palette by selecting it from the pencil texture palette list in the
Colour view —see Colour View on page 239.

106

Harmony 22 Paint Reference Guide

Icon

Property

Description

This option is available from the menu
Use as Default Pencil
Texture Palettebutton. Sets the currently

selected pencil texture palette as the default pencil texture palette inyour user preferences. The default pencil texture palette is added toevery scene you create in Harmony. The palette is copied in yourpreferences, so it w ill be added to your new scenes in the exact state it
is w hen you make it the default pencil texture palette.

Reload Default Texture
PaletteNew Texture

Imports the default pencil texture palette as a new pencil texture
palette into your scene's palette list, and selects it as the current pencil
texture palette.

Allow s you to import an image file into a new pencil texture sw atch inthe current pencil texture palette. The pencil texture's effect on yourpencil line w ill be based on the image's transparency channel, and w illfollow your pencil lines on its horizontal axis. This option is alsoavailable from the menu

Delete Texture

Rename Texture

Pencil Texture Display

button.

Deletes a pencil texture sw atch from the current pencil texture palette.
This option is also available from the menu

button.

Renames the selected pencil texture sw atch in the current pencil
texture palette. This option is also available from the menu

button.

Displays the pencil textures in the current pencil texture palette and107

Chapter 2: Tools Properties

Icon

Property

Description

allow s you to select one to use w ith the Pencil tool.

Pencil Texture Palette

Displays the name of the currently selected pencil texture palette, forreference. To select a different pencil texture palette, you must select itin the Colour view —see Colour View on page 239.

108

Harmony 22 Paint Reference Guide

Envelope Tool Properties
Selecting the Envelope tool displays its properties and options in the Tool Properties view .

Icon

Tool Name

Description

Increase the w idth and height values to add more columns and row s to thedeformation grids.

W idth andHeight

Sets the selection mode to Lasso, w hich allow s you to select multiple items bydraw ing a lasso around them.
Lasso

TIP
W hen this option is enabled, you can press and hold the Alt key totemporarily use Marquee mode.

Marquee

Sets the selection mode to Marquee, w hich allow s you to select multiple items
by draw ing a rectangle around them.

109Chapter 2: Tools Properties

Icon

Tool Name

Description

TIP
W hen this option is enabled, you can press and hold the Alt key totemporarily use Lasso mode.

Allow s you to enable or disable snapping for this tool and all other animationand draw ing tools that support snapping, as w ell as to select w hich types ofsnapping are enabled.
If you double-click or long-click on this button, it w ill open a pop-up menu in
w hich you can toggle different snapping modes. You can also click on thisbutton to toggle it off, w hich w ill disable all snapping modes, and click on it
again and toggle it on to re-enable the snapping modes w hich w ere previously
enabled.
This tool supports the follow ing snapping modes:

SnappinglSnap to Contour: W hile moving the selection or one of its control
points, it w ill snap against the nearby points and contours of yourartw ork, allow ing you to snap parts of your artw ork together.

lSnap to Alignment Guides: W hile moving the selection or one of its
control points, it w ill snap against nearby alignment guides.

lSnap and Align: W hen enabled, w hile moving a selection, therectangular bounding box of the selection w ill snap to the rectangularbounding box of any other draw ing stroke in the draw ing, allow ing you
to align draw ing strokes laterally.

lSnap to Grid: W hile moving the selection, the mouse cursor w ill snap
against the intersecting points of the grid.

TIP
To display the grid, select View > Grid > Show Grid from the top
menu or press Ctrl + '.

Show Advanced
Controls

To display more controls,you can click on the Show Advanced Controls button.

110Harmony 22 Paint Reference Guide

Icon

Tool Name

Description

Allow s you to perform draw ing operations on both the Line Art and Colour Art
layers of your draw ing simultaneously.
Apply to Lineand Colour Art

NOTE
If you have Overlay and Underlay Art layers enabled, they w ill also beaffected w hen this option is enabled.

Flip Horizontal

Flips the current selection horizontally.

Flip Vertical

Flips the current selection vertically.

Rotate 90
Degrees CW

Rotates the current selection 90 degrees clockw ise.

Rotate 90
Degrees CCW

Rotates the current selection 90 degrees counter-clockw ise.

SmoothYou can modify the central line smoothness of your line using this option. Thisparameter smooths the deformed lines. Increasing the value w ill result in asmoother line w ith few er control points. The more you increase the value, theless details and curves you w ill get. Use the left and right arrow s to increment
the value by one full unit. Use the Up - Dow n slider to quickly increment thevalue.

111

Chapter 2: Tools Properties

Eraser Tool Properties
The Eraser tool allow s you to erase artw ork by draw ing eraser strokes over it. W hen using the Eraser tool w ith
a tablet, it is pressure sensitive, like w ith the Brush and Pencil tool.

How to access the Eraser tool properties
1. In the Tools toolbar, select the Eraser

tool.

The tool's properties are displayed in the Tool Properties view .

Eraser Properties
The w ay the Eraser tool is configured is almost identical to the w ay the Brush tool is configured.
Property

Description

The Preview area lets you see a preview of the stroke your draw ing tool w ill make.
Stroke Preview Area

Eraser Properties
Dialog

The arrow button right of the display area opens the Eraser Properties dialog, w hichgives you access to all the parameters and options for your eraser. The Tool Properties112Harmony 22 Paint Reference Guide

Property

Description

view only gives you access to a few of the eraser properties, a list of eraser presets andoptions for the Eraser tool that are not related to the eraser properties. For more
information on the Eraser Properties dialog, see the Eraser Properties Dialog section
below .

Defines the maximum size of the eraser.
Maximum Size

Flow

If the tool is used w ith a pressure sensitive pen tablet, the w idth of the stroke w ill vary
betw een its maximum size and minimum size depending on the amount of pressureused. If used w ith a mouse, the w idth of the stroke w ill alw ays be its maximum size.

Lets you set the opacity for each instance of the eraser tip that gets erased from yourartw ork. Contrary to the Opacity parameter, the flow parameter has a cumulative effect.
This means that a low er flow w ill make your eraser strokes less effective tow ards its
extremities and more effective in its center. Your stroke's flow w ill also accumulate if
you draw over it. By default, your eraser's flow varies w ith the amount of pressure you
put on your tablet pen.

NOTE
This option is only displayed in the Tool Properties view w hen draw ing on abitmap layer.

The Opacity parameter are w here Lets you set the opacity of your brush strokes.
Contrary to the Flow parameter, the Opacity parameter is non-cumulative. Your w holebrush stroke's opacity w ill not exceed the Opacity parameter. By default, the Opacity
parameter varies depending on the amount of pressure you put on your tablet pen.
Opacity

NOTEThis option is only displayed in the Tool Properties view w hen draw ing on abitmap layer.

Eraser Presets
These options allow you to select, create and manage eraser presets.

113

Chapter 2: Tools Properties

Icon

Property

Description

Presets list

By default, Harmony has preloaded eraser presets. You can also
create your ow n eraser presets by configuring your eraser, thensaving its properties into a new preset. It is also possible to export
and import eraser presets.

New Brush Preset

Creates a new preset based on the current tool properties.

Delete Brush

Deletes the currently selected preset.

Rename Brush

Allow s you to rename the currently selected preset.

Import Brushes

Allow s you to import brush presets exported from Harmony.

Export Brushes

Allow s you to export your brush presets into an .xml file.

Small Thumbnail

Displays presets in a grid of small thumbnails w ith a preview of theirtip.

Large Thumbnail

Displays presets in a grid of big thumbnails, w ith their name and apreview of their tip.

Stroke View

Displays presets in a list, w ith their name and a preview of a stroke
done w ith each preset.

Erasing Options
These options affect the w ay your eraser strokes are applied to your artw ork.
Icon

Property

Description

Allow s you to perform draw ing operations on both the Line Art andColour Art layers of your draw ing simultaneously.
Apply to Line andColour Art

NOTE
If you have Overlay and Underlay Art layers enabled, they w illalso be affected w hen this option is enabled.

114

Harmony 22 Paint Reference Guide

Icon

Property

Description

W hen you erase part of a pencil line, this option determines the shape ofthe extremity of the pencil line w here you erased:lRound: Leaves a round tip at the extremities of the pencil
line you erased.

l

Flat: Leaves a flat tip at the extremities of the pencil line you
erased. A flat tip is alw ays perpendicular to the angle of thecentreline of the pencil line, so it may not match the angle of youreraser stroke.

Tip Stylel

Bevel: Leaves a bevel tip at the extremities of the pencil line
you erased. A bevel tip is flat, but its angle matches the angle ofyour eraser stroke.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as to selectw hich types of snapping are enabled.

Snapping

If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You can also
click on this button to toggle it off, w hich w ill disable all snapping
modes, and click on it again and toggle it on to re-enable the snapping
modes w hich w ere previously enabled.
This tool supports the follow ing snapping mode:lSnap to Alignment Guides: W hile erasing, the eraser w ill snap

115

Chapter 2: Tools Properties

Icon

Property

Description

against nearby alignment guides.

Apply to Synced
Draw ing Layers

If the currently selected layer is synced w ith another layer, the tool w ill
w ork on both the current layer and its synced layer.

Eraser Properties Dialog
Erasers have an extensive set of options and properties that are not displayed in the Tool Properties view , butrather, in a dialog you can access from it. To open the Eraser Properties dialog, click on the arrow button rightof the stroke display area.

The Eraser Properties dialog has five different tabs, minus the Smoothing tab if you are w orking on a bitmap
layers. Below is detailed information about the options available in each tab:l

Tip Tab on page 116lSmoothing Tab on page 123lTransparency Tab on page 124lDual Tip Tab on page 127lPaper Texture Tab on page 131

Tip TabThe Tip tab allow s you to configure the shape, size, hardness and spacing of your eraser tip.

116

Harmony 22 Paint Reference Guide

Property

Description

Allow s you to select betw een one of the follow ing eraser types:

Eraser Typel

Solid Vector: Simply cuts out the eraser stroke's shape from the vector artw ork.
A solid vector eraser alw ays completely erase the artw orks leaving hard seams.

lTextured Eraser: Allow s to configure the eraser w ith the same options as w ith
a textured brush. A textured eraser w ill decrease the opacity of bitmap texturesin textured brush strokes if it doesn't completely erase it. If it completely erases
a brush stroke, it w ill cut out the erased part from the vector artw ork.

lTextured, Preserve Vector: Like a Textured Eraser, except that it w ill not cut
out from the vector shapes, even if it fully erases pixels in a textured brushstroke's texture.

NOTE
Textured erasers only w ork as expected on textured brush strokes. Using a
Textured eraser on a solid vector brush stroke or on a pencil line w ill only cut theeraser stroke's shape out of it. If you use a Textured, Preserve Vector type eraser
on a solid vector shape or on a pencil line, the eraser w ill not erase anything.

117

Chapter 2: Tools Properties

Property

Description

NOTE
This option is not available w hen w orking on a bitmap layer. W ith bitmap layers,erasers are alw ays textured, and textured eraser options are alw ays available.

Eraser Tip LibraryThis is w here you select the shape of the eraser tip. By default, it is round. Note thatsome tips are designed to have semitransparent areas, even w hen the maximum eraser
opacity is set to 100%.
To create a custom eraser tip, you must prepare the file ahead of time, either inHarmony or in a third-party softw are, such as Adobe Photoshop. Colour is notsupported and transparency is not supported in the traditional sense. Black appears as
100% opaque, w hite appears as 100% transparent and all the shades of grey inbetw een appear as varying degrees of semitransparency. A range of file formats aresupported—.jpeg, .png, .tif, .psd, .tga to name a few . Alpha channels are disregardedon import. It is recommended that your file be betw een 100 x 100 pixels and 400 x 400
pixels.
You can also import eraser tips that you exported from Harmony, so you can sharethem w ith colleagues.

The minimum and maximum sizes of your draw ing tool produce the thick and thineffect on your stroke. This w orks w ith the pressure sensitivity of a pen tablet.

Minimum andMaximum SizelMaximum Size: Defines the maximum w idth of the stroke.

l

Minimum Size: Defines the minimum w idth of the stroke in relation to and as apercentage of the maximum size.

You can control the size properties by clicking on the arrow button on right and the
dialog box w ill appear as show n below .

118Harmony 22 Paint Reference Guide

Property

DescriptionlPressure: Allow s you to apply more pressure and increases the size of thebrush. You can check the box to invert this behaviour.

l

Tilt: Allow s you to tilt the pen closer to tablet for a bigger stroke. You can checkthe box to invert this behaviour.

l

Speed: Allow s you to reduce the size of the stroke by draw ing at a fast speed.
You can check the box to invert this behaviour.

l

Speed Sensitivity: A slider is used to control how fast must the stroke bedraw n to reach the minimum value.

lTaper: Allow s you to reduce the value of a property at the start or the end ofeach stroke. The value can be expressed using tw o options: Distance andPercentage. Distance is selected by default. For example: A taper of 200 w ill
be the same length as the w idth (diameter) of a stroke that has its size set at200.

You can enable Start and End Tapering option individually.
lStart Taper: W hen distance is selected as a Taper value, the effect of starttaper can be visualized as the stroke is draw n.

l

End Taper: W hen distance or percentage is selected as a Taper value, theeffect of end taper can be visualized once the stroke is complete and vectorized
as the length is unknow n until the stroke is complete.

l

Fade Distance: Allow s you to fade the value of property over a given distance.
It uses the same units as the size and is applied as the stroke is draw n.

119

Chapter 2: Tools Properties

Property

DescriptionlSize Proportional to Camera: If you check this option, the size of the w ill be
adjusted to the position of the camera on the z-axis. This means that if thecamera is zoomed in on the scene, the w ill be proportionally smaller so that it
appears the same size in the rendered image. Likew ise, if the camera is zoomed
out, the w ill be proportionally bigger.

NOTE
Setting the Minimum Size value to 100% eliminates the possibility of creating
w idth variation on your stroke. In other w ords, you w ould be forcing a uniform line
w idth using the Maximum Size value.

Proportional to Camera

If you check this option, the size of the eraser w ill be adjusted to the position of thecamera on the z-axis. This means that if the camera is zoomed in on the scene, theeraser w ill be proportionally smaller so that it appears the same size in the rendered
image. Likew ise, if the camera is zoomed out, the eraser w ill be proportionally bigger.

The Roundness and Angle parameters allow you to change the shape and orientationof the tip.
lRoundness: The vertical scaling to apply to the tip. Reducing this setting
squashes the tip vertically, allow ing you to turn round or square tips into flat
tips.

l

Roundness and Angle

Angle: The angle at w hich to rotate the brush tip, counterclockw ise.

NOTE
The squashing is not relative to the angle—if the tip is rotated, the squashing w ill
still be done relative to the tip's original orientation.

If your pen and tablet support tilt sensitivity, this option allow s you to set w hether youreraser takes your pen's tilt angle in account, and how much.
Pen Tilt Sensitivity

W hen your pen is fully tilted, your eraser tip w ill be stretched by the percentage you
set in this parameter, in the angle in w hich you tilt it. For example, if you set the Pen Tilt
Sensitivity to 50%, and you tilt your pen all the w ay up or dow n, your eraser tip w ill be
stretched vertically by 50%. W ith the same setting, if you tilt your pen all the w ay leftor right, your eraser tip w ill be stretched horizontally by 50%.

120

Harmony 22 Paint Reference Guide

Property

Description

If enabled, and if your pen and tablet support tip rotation, your eraser tip w ill rotate
w ith the angle of your pen tip.

Use Pen Rotation

The Hardness and Spacing parameters allow you to change the softness and spacingof the marks made by the eraser tip. You can preview the hardness and spacing at the
top of the Eraser Properties w indow , stroke preview area.

Hardness

Spacing

The hardness value corresponds to the softness of the eraser tip's edges. The low er
the value, the softer the tip edge. The higher the value, the sharper the tip edge. Be
aw are that some eraser tips are not 100% opaque, so they w ill alw ays appear
somew hat soft, even at 100% hardness.

Defines the amount of space betw een each stamp of the eraser. A value of 100% sets
the stamp marks edge to edge, if there is no w hite space around the shape. The larger
the value, the greater the space betw een marks. A really large value can make theeraser stroke appear as a string of individual marks. Conversely, a small spacing value
w ill give the appearance of a fluid brush stroke.
Spacing is only evident w hen making a continuous stroke.

121

Chapter 2: Tools Properties

Property

Description

Randomness

The Randomness parameters let you create a varied bitmap eraser stroke. Refining
these options can give your stroke a lovely, non-mechanical look.

You can create variation betw een the thick and thin of your eraser stroke just by setting
the Maximum and Minimum Size values. If you add randomness to the mix, pressure
sensitivity from your draw ing tablet w ill still be applied. Light pressure w ill create
random values around the minimum, w hile heavy pressure w ill create random values
closer to the maximum. The larger the percentage, the larger the range of randomvariation.

Random Size

NOTE
Setting the Minimum Size to 100% eliminates the possibility of creating w idthvariation on your stroke, w hether you are applying randomness or not. Therefore,
you w ould be forcing a uniform line w idth using the Maximum Size value.

Random Angle

Sets the range for random rotation around the set Angle value. For example, if theAngle is set to 45° and the Random Angle set to 10°, the softw are w ill choose values
betw een 40°–50° (plus or minus 5 degrees, equaling a total of 10 degrees).

122Harmony 22 Paint Reference Guide

Property

Description

Sets the range for random spacing around the set Spacing value. For example, if theSpacing is set to 50% and the Random Spacing is set to 10%, then Harmony w illchoose values betw een 45%–55% (plus or minus 5 percent, equaling a total of 10
percent).

Random Spacing

Smoothing Tab
The Smoothing tab contains options to configure how Harmony should automatically smooth your eraser
strokes as you paint.

123

Chapter 2: Tools PropertiesNOTE
The Smoothing tab is only available w hen w orking on a vector layer, as bitmap layers do notsupport smoothing.

Property

Description

Centerline Smoothing

Defines the amount of smoothing Harmony should perform on your eraser stroke's
direction, curves and corners. A higher setting w ill prevent your line from being
shaky, but is liable to reduce draw ing precision and turn sharp angles into curves.

Contour Smoothing

Defines the amount of smoothing Harmony should perform on outer contour of theeraser stroke. A higher setting w ill round sharp corners and reduce the amount ofcontrol points for the resulting vector shape.

Transparency Tab
The Transparency tab allow s you to decide if your eraser has antialiasing as w ell as to set its flow and opacity
settings.

124

Harmony 22 Paint Reference Guide

NOTE
The Transparency tab's options are only available on vector layers if the Eraser Type option of the
Tip tab is set to Textured Vector or Textured, Preserve Vector.. On bitmap layers, those options
are alw ays available.

Property

Description

Enabled by default. This option causes the contours of the eraser strokes toblend w ith the surrounding colours, to create an illusion of smoothness
otherw ise not possible due to the picture resolution.

Antialiasing

If antialiasing is disabled, the eraser w ill either fully erase pixels or leave themintact.

NOTE
W hen disabled, all other options in the Transparency tab are disabled.

The Maximum and Minimum Flow parameters let you set the range for the rate
at w hich your eraser's effect flow s. The greater the flow , the more consistent theeffect is. If the flow is light, then the effect may look spotty. This feature w orks
w ith the pressure sensitivity of a pen tablet.
l

Maximum Flow: Sets the maximum rate at w hich colour and texture areapplied as you create a fluid stroke.

l

Minimum Flow: Sets the minimum rate at w hich colour and texture areapplied as you create a fluid stroke. It is defined as a percentage of theMaximum Flow value. If the Minimum Flow value is set to 100%, thentablet pressure sensitivity w ill no longer be applicable. The flow w ill be
set to the constant rate of the Maximum Flow value.

Maximum and Minimum Flow

Maximum Opacity and
Minimum Opacity

The Maximum and Minimum Opacity parameters are w here you set the opacity
range for a eraser mark. This w orks w ith the pressure sensitivity of a pen tablet.
l

Maximum Opacity: Sets the transparency limit of the eraser mark w hen
the pressure is heavy.

125

Chapter 2: Tools Properties

Property

DescriptionlRandomness

Minimum Opacity: Sets the transparency limit of the eraser mark w hen
the pressure is very light. It is defined as a percentage of the Maximum
Opacity value. If the Minimum Opacity value is set to 100%, then tablet
pressure sensitivity w ill no longer be applicable. The opacity w ill be set
to the constant rate of the Maximum Opacity value.

Th Randomness parameter lets you set the range for the randomness of the flow
and opacity. This w orks w ith the pressure sensitivity of a pen tablet.

You can create variation in the flow of your eraser stroke just by setting theMaximum and Minimum Flow values. If you add randomness to the mix, pressure
sensitivity from your draw ing tablet w ill still be applied. Light pressure w illcreate random values around the minimum, w hile heavy pressure w ill create
random values closer to the maximum. The larger the percentage, the larger therange of random variation.

Randomness Flow

NOTE
Setting the Minimum Flow value to 100% eliminates the possibility ofcreating flow variation on your stroke, w hether you are applying
randomness or not. That is, you w ould be forcing a uniform flow using theMaximum Flow value.

126

Harmony 22 Paint Reference Guide

Property

Description

You can create variation in the opacity of your eraser stroke just by setting theMaximum and Minimum Opacity values. If you add randomness to the mix,pressure sensitivity from your draw ing tablet w ill still be applied. Light pressure
w ill create random values around the minimum, w hile heavy pressure w ill create
random values closer to the maximum. The larger the percentage, the larger therange of random variation.

Random Opacity

NOTE
Setting the Minimum Opacity value to 100% eliminates the possibility ofcreating opacity variation on your stroke, w hether you are applying
randomness or not. That is, you w ould be forcing a uniform opacity using
the Maximum Opacity value.

Dual Tip Tab
The Dual Tip tab lets you set the parameters for creating a dual tip eraser. The primary bitmap eraser tip andthe dual tip alw ays w ork together. You can set the parameters for the primary tip in the Tip tab and those forthe dual tip in the Dual Tip tab. The Blend mode you select determines how the tips are combined.
By default, the Blend Mode is set to Multiply and the Random Angle to 360°.

127Chapter 2: Tools Properties

NOTE
To use a Dual Tip, you must enable option by checking the checkbox inside the Dual Tip tab.
Additionally, if you are w orking on a vector layer, the Eraser Type option of the Tip tab must be set
to Textured Vector or Textured, Preserve Vector.

Tool Name

Description

Enable/Disable

The checkbox inside the tab allow s you to decide w hether or not your eraser uses adual tip. If this checkbox is unchecked, the options in the Dual Tip tab w ill bedisabled.

Blend Mode

The Blend modes let you decide how the primary tip and the dual tip are combined.

Multiply

This is the default blend mode. W hen the tw o eraser tips are combined in this mode,
they essentially cut each other out in overlapping areas, w here one or both tips havean area of 100% transparency. The less opaque the eraser tips are, the lighter their128

Harmony 22 Paint Reference Guide

Tool Name

Description

combination.

Colour Dodge

In this mode, the primary tip cuts out the shape of the dual tip. W here the tip shapes
overlap, w ithin the boundaries of the primary shape, the colour and opacity appear
darker.

129

Chapter 2: Tools Properties

Tool Name

CombineDescription

This mode treats the tw o tips as tw o different and separate erasers that have thesame colour and follow the same path.

130

Harmony 22 Paint Reference Guide

Tool Name

Description

Paper Texture Tab
The Paper Texture tab lets you configure a paper-like texture for your eraser. You can also add textures byimporting image files, or import paper textures that w ere previously exported from Harmony.

131

Chapter 2: Tools Properties

NOTE
To use a Paper Texture, you must enable option by checking the checkbox inside the Paper
Texture tab. Additionally, if you are w orking on a vector layer, the Eraser Type option of the Tip
tab must be set to Textured Vector or Textured, Preserve Vector.

Property

Description

Enable/Disable

The checkbox inside the tab allow s you to decide w hether or not your eraser uses apaper texture. If this checkbox is unchecked, the options in the Paper Texture tab w ill
be disabled.

Texture Scale

Increase or decreases the size of the paper texture.

Additive

This option layers the texture on top of itself as you scribble overlapping lines in one
continuous stroke. If this option is turned off, areas of overlapping lines from a single,
continuous stroke w ill appear the same, in terms of darkness and texture, as non-132

Harmony 22 Paint Reference Guide

Property

Description

overlapping areas.

This option defines the w ay separate, overlapping strokes behave. If this option isenabled, the paper texture's position does not change w ith each sw eep of the eraser.
If this option is disabled, each sw eep of the eraser produces a different texture
position. The texture orientation alw ays stays the same.

Aligned133

Chapter 2: Tools Properties

Ink Tool Properties
W hen you select the Ink tool, its properties and options appear in the Tool Properties view .

Icon

Tool Name

Tool

Sets the selection mode to Lasso, w hich allow s
you to select multiple items by draw ing a lasso
around them.
Lasso

TIP
W hen this option is enabled, you canpress and hold the Alt key to temporarily
use Marquee mode.

Sets the selection mode to Marquee, w hich allow s
you to select multiple items by draw ing a rectangle
around them.
MarqueeTIP
W hen this option is enabled, you canpress and hold the Alt key to temporarily
use Lasso mode.

Show Inkable Lines

Highlights all pencil lines (no brush strokes) on theselected layer. Pencil line segments that are
already inked w ith the selected sw atch colour fromthe colour palette are also not highlighted.

Be Smart on Connecting Lines

As you hover and move the cursor acrossintersecting pencil lines, the path that you create
w ill be highlighted. W hen you click on your mouseor stylus the highlighted segments are inked. W ith
this option disabled, all the intersecting segmentsthat your cursor comes near w ill be highlighted
and become part of the selection, even if they w ere
not situated in the direction of the chosen path.

134

Harmony 22 Paint Reference Guide

NOTE
This option only w orks if the Ink tool is in
Hover mode.

Use this mode instead of the Hover Mode. In the
Hover Mode, any potentially inkable pencil line w ill
have its central vector line highlighted as the Inktool’s cursor hovers over it. Use Ctrl

Select Mode

(W indow s/Linux) or ⌘ (macOS) to toggle betw een
the tw o modes.

In the Paint tool properties, this option keeps aselection highlighted around the latest paintedzone after using the Paint, Repaint, Unpaint, orPaint Unpainted tool.

Select New ly Painted, Repainted,
and Unpainted Contours/LinesRaise

As you ink the pencil line, the segment w ill be
moved on top of the other intersecting strokes.
Disable this option for the line to be sent behind.
Hold dow n the Alt key to perform the opposite
operation as you ink.

Mitre

As you hover over tw o perpendicular or nearly
perpendicular segments, a highlighted path w ith acorner is created. Clicking on these highlighted
segments inks both segments and makes themappear as a single stroke w ith a corner or bend.
Options include: As Is, Round, Miter, and Bevel.

Tip StyleLets you customize the edge of the Ink tool.
Options include: Round, Flat, and Bevel.

135Chapter 2: Tools Properties

Line Tool Properties
The Line tool allow s you to quickly draw a line segment by dragging the mouse from its starting point to its
end point.

How to access the Line tool properties
1. In the Tools toolbar, select the Linetool.

The tool's properties are displayed in the Tool Properties view .

Pencil Properties
Just like other shape tools, this tool creates pencil lines. Hence, its tool properties are similar to the ones of thePencil tool and it can be used w ith pencil presets.

136

Harmony 22 Paint Reference Guide

Tool Name

Description

The Preview area lets you see a preview of the stroke your draw ing tool w ill make.
Preview Area

The arrow button right of the preview area opens the Pencil Properties dialog.

Pencil Properties
DialogSize

W hile the Tool Properties view only gives you access to a few of the pencil properties,
a list of pencil presets and other draw ing options, the Pencil Properties dialog gives youaccess to all the available options for your pencil's shape and texture. For more
information on the Pencil Properties dialog, see the Pencil Properties Dialog section
below .

Defines the w idth of the pencil line used to draw the line.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew . You
can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You can choose
betw een Round, Mitre and Bevel style.

Pencil Presets
These options allow you to select, create and manage pencil presets.

137

Chapter 2: Tools Properties

Icon

Property

Description

Harmony provides a variety of pencil presets and thickness stencils andalso lets you create and save your ow n. It is a good idea to create andsave pencils w ith precise sizes and parameters w hen you draw for
efficiency and consistency.

Presets list

A thickness stencil saves the thickness information across the length ofthe line. W hen draw ing w ith a thickness stencil, the pressure sensitivityof the tablet is discarded. A thickness stencil can be used w hile draw ing,
or applied afterw ards.
You also have the possibility to apply different textures to your lines byeither using the default presets or to import your ow n.
You can export the pencil presets that you have created and importthose that others have created. This is a good w ay for you and project
collaborators to keep a consistent look for the project.

New Brush Preset

Creates a new preset based on the current tool properties.

Delete Brush Preset

Deletes the currently selected preset.

Open a menu that contains the follow ing options:l

New Brush Preset: Creates a new preset based on the current
tool properties.

lDelete Brush: Deletes the currently selected preset.

lRename Brush: Allow s you to rename the currently selected
preset.

lImport Brushes: Allow s you to import brush presets exported
from Harmony.

l

Export Brushes: Allow s you to export your brush presets into an.xml file.

l

Small Thumbnail: Displays presets in a grid of small thumbnails
w ith a preview of their tip.

lLarge Thumbnail: Displays presets in a grid of big thumbnails,
w ith their name and a preview of their tip.

lStroke View: Displays presets in a list, w ith their name and apreview of a stroke done w ith each preset.

Brush Presets Menu

Drawing Options
These options affect the w ay your draw ing strokes are added to your artw ork.

138

Harmony 22 Paint Reference Guide

Icon

Tool Name

Description

W hen enabled, your brush strokes w ill appear behind the existing artw ork.

Draw Behind

NOTEYour brush stroke w ill temporarily appear over your artw ork as you
draw it, until you release the mouse cursor or tablet pen.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as to selectw hich types of snapping are enabled.
If you double-click or long-click on this button, it w ill open a pop-up menu in
w hich you can toggle different snapping modes. You can also click on thisbutton to toggle it off, w hich w ill disable all snapping modes, and click on it
again and toggle it on to re-enable the snapping modes w hich w ere
previously enabled.
This tool supports the follow ing snapping modes:
SnappinglSnap to Contour: W hen enabled, w hile you're draw ing, the mouse
cursor w ill automatically snap to the nearby contours of existingartw ork, allow ing you to draw shapes that connect w ith other partsof your draw ing.

139

Chapter 2: Tools Properties

Icon

Tool Name

Description

NOTE
If you draw a line w ith the Line tool and make its tip snap to acontour or another control point in your artw ork, they w ill belocked together. You can then manipulate both
simultaneously using theContour Editor tool. You canalso separate tw o draw ing strokes that have been snapped
together by selecting one of them w ith theSelect tooland moving it aw ay.

lSnap to Alignment Guides: W hile draw ing, the draw ing tool w ill
snap against nearby alignment guides.

lSnap and Align: W hen enabled, w hile you're draw ing, the mouse
cursor w ill automatically align w ith the edges of strokes and shapes
in your artw ork, allow ing you to draw shapes that align w ith parts ofyour draw ing.

l

W hen enabled, w hile you're draw ing, the mouse cursor w ill snap
against the intersecting points of the grid.

TIP
To display the grid, select View > Grid > Show Grid from the
top menu or press Ctrl + '.

As you draw in the Line Art layer, the Automatically Create Colour Art
option instantly creates the corresponding strokes in the Colour Art layer.
AutomaticallyCreate Colour Art

140

Harmony 22 Paint Reference Guide

Icon

Tool Name

Description

By default, w hen draw ing on a vector layer, each new stroke is created as aseparate draw ing object, w hich can be edited independently from otherparts of the artw ork. W hen enabled, the Auto-Flatten option automaticallymerges strokes into existing artw ork.

Auto-Flatten Mode

NOTE
Using the Select tool, you can use select and remove a segment offlattened pencil lines. Overlapping pencil lines draw n w ith the AutoFlatten mode are essentially cut into segments by the overlap and canbe treated as individual lines.

W hen enabled, small gaps betw een the pencil lines you draw w ill be closed
by an invisible stroke to make sure your shapes are closed and that they canbe filled w ith the Paint tool.

Auto-Close Gap

Line Building Mode

W hen draw ing contours w ith pencil lines, the centreline is used todetermine w hether or not the contour is closed, but the visible tips of thepencil line w ill extend a bit beyond the tips of its centreline, making it
possible to have shapes that appear closed, but are not really. This canprevent the shape from being filled w ith the Paint tool. Enabling this option
w hen draw ing w ith the Pencil or Line tool w ill prevent you from leaving
invisible gaps in your contours.

The Line Building mode is very useful w hen draw ing long lines and curves
in small increments w ith pencil lines or the Line tool. As the pencil lines arecentral vector lines, it may be difficult to align the line tips perfectly tocreate a uniform stroke and close all gaps.

141Chapter 2: Tools Properties

Icon

Tool Name

Description

In this mode, you can draw lines in small increments and the tips are merge
into one single stroke.

NOTE
This mode only w orks w ith pencil lines or the line tool.

Use Stored Colour
Gradient

The Use Stored Colour Gradient option can be used w hen painting w ith agradient colour to alw ays position the gradient in the same w ay it w asstored, making it consistent across brush strokes. You can store a gradientby selecting a zone painted w ith a gradient w ith the Select tool, thenclicking on Store Colour Gradientin the Tool Properties view .

Draw s a straight line.
In this mode, you can draw curved lines w ith the follow ing method:
1. Draw the line by clicking and dragging from the start point to theend point of the line, but don’t release the mouse button or pen yet.

Straight Line Mode

2. W hile holding the mouse button or pen dow n, press and hold theCtrl (W indow s/Linux) or ⌘ (macOS) and move the mouse or pen to
define the line’s curve.

3. Once the line’s curve looks right, release the mouse button or pen.

142

Harmony 22 Paint Reference Guide

Icon

Tool Name

Description

This mode allow s you to draw s a simple curved (quadratic Bezier) line in
tw o clicks:
1. Draw the line by clicking and dragging from the start point to theend point of the line.

Curve Line Mode
2. Move the mouse or pen to define the curve of the line and click.

Draw s an S-shaped (cubic Bezier) line. This mode allow s you to draw lines
w ith finely tuned or even S-shaped curves w ith three clicks:
1. Draw the line by clicking and dragging from the start point to theend point of the line.

S Curve Line Mode

2. Move the mouse or pen to define the Bezier position of the
beginning of the line and click.

3. Move the mouse or pen to define the Bezier position of the end of
the line and click.

143

Chapter 2: Tools Properties

Icon

Tool Name

Description

Pencil Properties Dialog
Since the Line tool draw s pencil lines, you can use the Pencil Properties dialog to customize the type of lines it
draw s. To open the Pencil Properties dialog, click on the arrow button right of the stroke display area.

Size and Smoothness Tab
The Size and Smoothness tab allow s you to select your pencil's size, its smoothing parameters as w ell as theshape of its tips and corners.

Property

Description

Maximum Size

Defines the maximum size of the pencil line. If the tool is used w ith a pressure

144

Harmony 22 Paint Reference Guide

Property

Description

sensitive pen tablet, the w idth of the stroke w ill vary betw een its maximum size andminimum size depending on the amount of pressure used. If used w ith a mouse, thew idth of the stroke w ill alw ays be its maximum size.

Minimum Size

Defines the minimum size of your stroke as a percentage of the maximum size. If you
do not have pressure sensitivity from a pen table, the minimum size value w ill beignored.

Proportional to Camera

If you check this option, the size of the pencil w ill be adjusted to the position of thecamera on the z-axis. This means that if the camera is zoomed in on the scene, thepencil w ill be proportionally smaller so that it appears the same size in the rendered
image. Likew ise, if the camera is zoomed out, the pencil w ill be proportionally bigger.

Centerline Smoothing

Defines the amount of smoothing Harmony should perform on the central line of thepencil stroke. A higher setting w ill prevent your line from being shaky and w ill reduce
the amount of control points it has, making it easier to tw eak, but is liable to reducedraw ing precision and turn sharp angles into curves.

Defines the amount of smoothing Harmony should perform on the outer contour ofthe pencil stroke.

Contour Smoothing

A pencil line is defined by its centreline and its variations in thickness, rather than its
apparent shape. W hen draw ing a pencil line w ith a mouse, its thickness is uniform.
Therefore, its outer contour does not have any control point, except at its extremities,
and no smoothing is required for its contour.
How ever, w hen draw ing a pencil line w ith a pressure sensitive tablet, its contour w ill
have control points and Bezier curves to define the line's variations in thickness, andthus smoothing must be performed on its contour. An increased contour smoothing
w ill reduce the amount of control points on the line's thickness and smoothen its
curves, but may affect the precision of the variations in line thickness.

You can adjust the start, end, and join style of a pencil line.

Shape
l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew .
You can choose betw een Round or Flat style.

145

Chapter 2: Tools Properties

Property

DescriptionlJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You canchoose betw een Round, Mitre and Bevel style.

Texture Tab
In the Pencil Properties view , the Texture tab allow s you to select a pencil texture from the currently selected
pencil texture palette to use w ith the Pencil tool. You can also add, remove or rename textures, save thecurrent pencil texture palette as the default one, or import the pencil texture palette into your scene.
The pencil texture palette used in the Texture tab of the Pencil Properties dialog is the one selected in the
Colour view . You can select a pencil texture palette by selecting it from the pencil texture palette list in the
Colour view —see Colour View on page 239.

Icon

Property

Description

This option is available from the menu
Use as Default Pencil
Texture Palette

Reload Default Texture
Palettebutton. Sets the currently

selected pencil texture palette as the default pencil texture palette inyour user preferences. The default pencil texture palette is added toevery scene you create in Harmony. The palette is copied in yourpreferences, so it w ill be added to your new scenes in the exact state it
is w hen you make it the default pencil texture palette.

Imports the default pencil texture palette as a new pencil texture
palette into your scene's palette list, and selects it as the current pencil

146

Harmony 22 Paint Reference Guide

Icon

Property

Description

texture palette.

New Texture

Allow s you to import an image file into a new pencil texture sw atch inthe current pencil texture palette. The pencil texture's effect on yourpencil line w ill be based on the image's transparency channel, and w illfollow your pencil lines on its horizontal axis. This option is alsoavailable from the menu

Delete Texture

Rename Texture

Pencil Texture Display

Pencil Texture Palettebutton.

Deletes a pencil texture sw atch from the current pencil texture palette.
This option is also available from the menu

button.

Renames the selected pencil texture sw atch in the current pencil
texture palette. This option is also available from the menu

button.

Displays the pencil textures in the current pencil texture palette andallow s you to select one to use w ith the Pencil tool.

Displays the name of the currently selected pencil texture palette, forreference. To select a different pencil texture palette, you must select itin the Colour view —see Colour View on page 239.

147

Chapter 2: Tools Properties

Paint Tool Properties
The Paint tool allow s you to fill closed areas of your draw ing w ith the selected colour.

How to access the Paint tool properties
1. In the Tools toolbar, select the Paint, Paint Unpainted, Repaint

or Unpainttool.

The tool's properties are displayed in the Tool Properties view .

Paint Tool Options
Icon

Property

Description

Allow s you to choose the method to visually select multiple elements:lLasso: Allow s you to select multiple elements by draw ing anirregular closed shape around them w ith your mouse.

lSelection Mode

Marquee: Allow s you to select multiple elements by draw ing a
rectangle around them. This is faster, as you only need to dragyour mouse from one corner of the rectangle to its opposite corner,
but it may not be as precise as you w ant.

TIP
You can press and hold the Alt key to temporarily use the otherselection mode.

148

Harmony 22 Paint Reference Guide

Icon

Property

Description

The Paint tool has four different modes:lPaint: Paints or repaints selected zones, w hether or not they
are already filled.

lPaint Mode

Paint Unpainted: Only paints empty zones, and does not
repaint zones that are already filled w ith colour.

lRepaint: Only paints zones that are already filled w ith colour,and does not fill empty zones.

l

Unpaint: Removes colour from the selected zone, replacing it
w ith transparency.

Paint and Remove
Textures

The Paint and Remove Texture option is used w hen you vectorized images
as greyscale texture style. An image vectorized as texture is a mix ofbitmap filling encapsulated in a vector-based frame. Painting a textured
zones w ith the Paint tool w ill change the tint of the textured lines.
Painting the textured zones using the Paint and Remove Texture option
transforms the bitmap filling into a 100% vector based zone and fills it
w ith a solid colour.

This option allow s you to select w hich layers the tool should affect. It canbe toggled on or off. W hen toggled on, it has tw o different modes. You
can select a mode by clicking and holding on the button.

Apply to Visible
Draw ing LayerslOff: W hen this button is toggled off, the tool only w orks on thecurrently selected layers. If several layers are selected, the tool
w ill w ork on all these layers simultaneously.

l

On W hen this button is toggled on, the tool w ill w ork on all thevisible layers.

l

Apply to Visible Drawing Layers: The tool w ill w ork on all thevisible layers in the Camera view .

lApply to Synced Drawing Layers: If the currently selected
layer is synced w ith another layer, the tool w ill w ork on both thecurrent layer and its synced layer.

149

Chapter 2: Tools Properties

Icon

Property

Description

NOTE
This option only w orks in the Camera view .

This option allow s you to determine w hich draw ings in the current layer
the tool should affect. It can be toggled on or off. W hen toggled on, it has
tw o different modes. You can select a mode by clicking and holding on the
button.
ll

Off: W hen this button is toggled off, the tool only w orks on thedraw ing in the current frame.
Apply to All Frames: The tool w ill w ork on every exposeddraw ing in the selected layer simultaneously.

lApply to All Frames

Respect Protected
ColourUse Stored Colour
Gradient

Apply to Onion Skin Range: The tool w ill w ork on every
draw ing displayed in the Onion Skin. Onion Skin must be enabled
for this option to w ork.

The Respect Protected Colour option is enabled by default. In your Colour
view , you can protect some colour sw atches to avoid repainting or
unpainting the zones linked to that sw atch.
If you disable this option the Paint tool w ill not follow the protect colour
rule and w ill repaint or unpaint the protected colours on your draw ings
until you enable the option again.

W hen you paint a zone w ith a gradient or textured colour sw atch, thegradient or texture’s position is set relative to the size of the zone you are
painting. If you w ant the Paint tool to use a particular size and position,
you must first store your desired position and size using the Select tooland then enable the Use Stored Colour Gradient option in the Paint tool
properties.

150Harmony 22 Paint Reference Guide

Icon

Property

Description

In the Paint tool properties, this option keeps a selection highlighted
around the latest painted zone after using the Paint, Repaint, Unpaint, orPaint Unpainted tool.
Select New ly
Painted, Repainted,
and Unpainted
Contours/Lines

By default, if you attempt to fill a shape that has a small gap in its contour,
the Paint tool w ill not be able to fill the shape. This option allow s you tomake the Paint tool automatically add a stroke to close the shape w hen it
detects a small gap betw een tw o strokes in the shape.
The Close Gap setting can be set to a value betw een 0 and 10. This
determines the maximum size of a gap to close, in pixels. You can also use
one of the follow ing presets:
Close Gapl

No Close Gap: Sets the Close Gap setting to 0, disabling thefeature.

l

Close Small Gap: Sets the Close Gap setting to 2, making the
Paint tool close gaps that are barely visible.

l

Close Medium Gap: Sets the Close Gap setting to 4, making
the Paint tool close gaps that are somew hat visible.

l

Close Large Gap: Sets the Close Gap setting to 8, making the
Paint tool close gaps that are easy to notice.

151

Chapter 2: Tools Properties

Bitmap Options
Since bitmap draw ings are made of pixels instead of shapes, and that the outlines of shapes in bitmap
draw ings are often feathered, it can be complicated to figure out exactly the area the Paint tool must fill w hen
trying to fill a zone in a bitmap draw ing. For example, if the Paint tool only replaces pixels w ith the exact same
colour as the one you click on w ith the selected colour, it w ill leave a small gap near the outlines of the shape.

The follow ing settings determine how the Paint tool figures out the area it must fill. W hen any of thesesettings are increased, the Paint tool's tolerance for colour or alpha differences increases and it w ill a bigger
area that it otherw ise w ould.
Icon

Property

Description

Allow s you to select w hich art layer to use in order to determine thefillable zone. By default, this is set to Current Art, w hich means thelayer you are filling w ill be used to determine the fillable zone.
How ever, if you w ant to keep your colour art on the Colour Art layer
and the line art on the Line Art layer, you can set the Source to Line Art, and then use the Paint tool on the Colour Art layer. The Paint tool

Sourcew ill use the artw ork in the Line Art layer to determine the area to fill
w ith colour, but w ill still add this colour to the Colour Art layer.
This property has the follow ing options:llCurrent Art: Bases the zone to fill on the current art layer.
Line Art: Bases the zone to fill on the Line Art layer,
regardless of w hich layer you are painting on.

lColour Art: Bases the zone to fill on the Colour Art layer,
regardless of w hich layer you are painting on.

--

Alpha

The alpha threshold that separates opaque and transparent zones.
W hen filling a "transparent" zone, the paint tool w ill apply the colour
under semi-transparent pixels, making them opaque. Then filling an"opaque" zone, the paint tool w ill replace the colour of semitransparent pixels w ithout affecting their transparency.
If you w ant to repaint lineart or shapes that have no outlines, you cando so by decreasing this setting completely. This w ill make it fill any

152Harmony 22 Paint Reference Guide

Icon

Property

Description

pixel that isn't 100% transparent, so it w ill paint your outlines
completely. How ever, if you're using this method to repaint outlines,
they must not be filled yet for this method to w ork.
If you w ant to paint transparent zones that have dirt or semitransparent spots, you can increase this setting to make the Paint tool
paint behind them instead of around them.

NOTE
Raising this setting too high may cause the paint tool to ignore
outlines that are not 100% opaque, w hich can cause it to think
the shape is not closed. Hence, it might fail to find a zone to fill
and not do anything.

--

Colour Tolerance

The amount of tolerance the paint tool has for changes in colour w hen
filling an area. Raising this setting w ill allow the paint tool to fill overareas that have some variations in colour, but may cause it to fillbeyond the areas you meant to paint.

The maximum amount of pixels beyond the fillable zone that the Paint
tool can fill.
W hen this setting is set to any value above zero, the paint tool w ill fill
the zone until it finds a pixel that is a different colour, value ortransparency as the one you clicked on. Then, it w ill start filling pixels
beyond that point, up until it filled the amount of pixels in the
Maximum Overlap setting.
--

Maximum Overlap

If it lands outside of a fillable zone before it reached the maximum
overlap, it w ill stop filling at that point. How ever, if it lands intoanother fillable zone before reaching its maximum overlap, it w ill fillthat zone as w ell. Therefore, if you're filling shapes inside othershapes, you have to set this setting to the approximate w idth of youroutlines. Setting it higher w ill make the colour spill beyond the zone
you clicked on and fill the zone outside of it, and setting it low er isliable to leave a small gap betw een the fill and the outlines.

153

Chapter 2: Tools Properties

Icon

Property

Description

NOTE
W hen you fill a zone w ith overlap, Harmony tries to detect andpreserve the outlines of your shape. This is easy to do w hen
filling a transparent shape, or w hen repainting a shape made ofsolid outlines and a solid fill. How ever, if you are trying torepaint an already painted zone, it may fail to detect youroutlines and may repaint over them if the colour of youroutlines or inside the shape isn't consistent. Therefore, it ishighly recommended to avoid repainting painted zones as muchas possible w hen w orking w ith bitmap layers.

W hen enabled, the outlines of the fill w ill be smoothed so that they do
not look pixelated.

Antialiasing

NOTE
The effect of this setting w ill not be visible if you fill all the w ay
to the outlines, as the Paint tool w ill preserve the antialiasing ofexisting outlines w hen filling up to them.

154Harmony 22 Paint Reference Guide

Pencil Tool Properties
The Pencil tool allow s you to draw simple contour lines that are defined by their centerline and their thickness.
W hen you select the Pencil tool, the Tool Properties view displays the different Pencil modes that control how
the pencil line is draw n.

How to access the Pencil tool properties
1. In the Tools toolbar, select the Pencil

tool.

The tool's properties are displayed in the Tool Properties view .

Pencil Properties
The follow ing properties affect the pencil's size, smoothing, shape and other properties for the draw ing styleof your pencil. Those properties can be saved into pencil presets for later use.
Property

Description

The Preview area lets you see a preview of the stroke your draw ing tool w ill make.
Preview Area

155

Chapter 2: Tools Properties

Property

Description

The arrow button right of the preview area opens the Pencil Properties dialog.

Pencil Properties
DialogW hile the Tool Properties view only gives you access to a few of the pencil properties,
a list of pencil presets and other draw ing options, the Pencil Properties dialog gives youaccess to all the available options for your pencil's shape and texture. For more
information on the Pencil Properties dialog, see the Pencil Properties Dialog section
below .

Defines the maximum w idth of the pencil line.
Maximum Size

Centerline Smoothing

If the tool is used w ith a pressure sensitive pen tablet, the w idth of the stroke w ill vary
betw een its maximum size and minimum size depending on the amount of pressureused. If used w ith a mouse, the w idth of the stroke w ill alw ays be its maximum size.

Defines the number of control points added to the centre line. The few er the control
points the smoother (but less faithful) the line.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew . You
can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You can choose
betw een Round, Mitre and Bevel style.

Pencil Presets
These options allow you to select, create and manage pencil presets.

156

Harmony 22 Paint Reference Guide

Icon

Property

Description

Harmony provides a variety of pencil presets and thickness stencils andalso lets you create and save your ow n. It is a good idea to create andsave pencils w ith precise sizes and parameters w hen you draw for
efficiency and consistency.

Presets list

A thickness stencil saves the thickness information across the length ofthe line. W hen draw ing w ith a thickness stencil, the pressure sensitivityof the tablet is discarded. A thickness stencil can be used w hile draw ing,
or applied afterw ards.
You also have the possibility to apply different textures to your lines byeither using the default presets or to import your ow n.
You can export the pencil presets that you have created and importthose that others have created. This is a good w ay for you and project
collaborators to keep a consistent look for the project.

New Brush Preset

Creates a new preset based on the current tool properties.

Delete Brush Preset

Deletes the currently selected preset.

Open a menu that contains the follow ing options:l

New Brush Preset: Creates a new preset based on the current
tool properties.

lDelete Brush: Deletes the currently selected preset.

lRename Brush: Allow s you to rename the currently selected
preset.

lImport Brushes: Allow s you to import brush presets exported
from Harmony.

l

Export Brushes: Allow s you to export your brush presets into an.xml file.

l

Small Thumbnail: Displays presets in a grid of small thumbnails
w ith a preview of their tip.

lLarge Thumbnail: Displays presets in a grid of big thumbnails,
w ith their name and a preview of their tip.

lStroke View: Displays presets in a list, w ith their name and apreview of a stroke done w ith each preset.

Brush Presets Menu

Drawing Options
These options affect the w ay your draw ing strokes are added to your artw ork.

157

Chapter 2: Tools Properties

Icon

Property

Description

W hen enabled, your brush strokes w ill appear behind the existingartw ork.

Draw Behind

NOTEYour brush stroke w ill temporarily appear over your artw ork as
you draw it, until you release the mouse cursor or tablet pen.

W hen enabled, draw ing a closed shape w ill automatically fill it w ith thecurrently selected Paint colour.

Auto Fill

TIP
By default the pencil line and its fill w ill be the same colour. To
select different colours for the line and its fill, do the follow ing:
1. In the Colour view , click the
2. Click on the

Unlock Three Colours button.

Set Current Pencil Colour sw atch. Then, inthe colour list, select the desired colour sw atch for youroutline.
3. Click on the

Set Current Paint Colour sw atch. Then, in thecolour list, select the desired colour sw atch for the fill.

W hen enabled, draw ing a closed shape w ill automatically remove theoutstanding lines.
Trim Extra Lines158

Harmony 22 Paint Reference Guide

Icon

Property

Description

W hen the Trim Extra Lines option is enabled, enable this option to makethe point w here the beginning and end of the stroke meet into a smooth
curve rather than a hard corner.

Align Handles AfterTrim

As you draw in the Line Art layer, the Automatically Create Colour Art
option instantly creates the corresponding strokes in the Colour Art
layer.
Automatically Create
Colour Art

By default, w hen draw ing on a vector layer, each new stroke is createdas a separate draw ing object, w hich can be edited independently fromother parts of the artw ork. W hen enabled, the Auto-Flatten option
automatically merges strokes into existing artw ork.

Auto Flatten

NOTE
Using the Select tool, you can select and remove a segment offlattened pencil lines. Overlapping pencil lines draw n w ith theAuto-Flatten mode are essentially cut into segments by theoverlap and can be treated as individual lines.

Auto-Close Gap

W hen enabled, small gaps betw een the pencil lines you draw w ill beclosed by an invisible stroke to make sure your shapes are closed and159

Chapter 2: Tools Properties

Icon

Property

Descriptionthat they can be filled w ith the Paint tool.
W hen draw ing contours w ith pencil lines, the centreline is used todetermine w hether or not the contour is closed, but the visible tips of thepencil line w ill extend a bit beyond the tips of its centreline, making it
possible to have shapes that appear closed, but are not really. This canprevent the shape from being filled w ith the Paint tool. Enabling thisoption w hen draw ing w ith the Pencil or Line tool w ill prevent you fromleaving invisible gaps in your contours.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as to selectw hich types of snapping are enabled.

Snapping

If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You can also
click on this button to toggle it off, w hich w ill disable all snapping
modes, and click on it again and toggle it on to re-enable the snapping
modes w hich w ere previously enabled.
This tool supports the follow ing snapping mode:lLine Building Mode

Snap to Alignment Guides: W hile draw ing, the draw ing tool
w ill snap against nearby alignment guides.

The Line Building mode is very useful w hen draw ing long lines andcurves in small increments w ith pencil lines or the Line tool. As the
pencil lines are central vector lines, it may be difficult to align the line
tips perfectly to create a uniform stroke and close all gaps.
In this mode, you can draw lines in small increments and the tips are
merge into one single stroke.

160Harmony 22 Paint Reference Guide

Icon

Property

Description

NOTE
This mode only w orks w ith pencil lines or the line tool.

The Auto Adjust Thickness tool is useful w hen you w ant to render aportion of a line thicker. W hen tracing a draw ing on paper, you w ill often
go back to a section of a curve to make it thicker to add dynamism to theline. Using the Auto Adjust Thickness tool, you can draw highlightstrokes over the section to make thicker. Once you release the pen or
mouse, the line becomes thicker follow ing the shape and curve of theoriginal stroke. This w ay is much faster and smoother than using thePencil Editor tool. You do not have to add extra points and adjust theposition and Bezier handles.
Auto Adjust Thickness

The default overlay colour is light yellow . If this colour is difficult to see
because of the background or draw ing colour, you can adjust the colour.

Line Pushing Mode

The Line Pushing Mode option lets you draw highlight strokes overexisting pencil lines. You can reshape the curves. Depending how you
draw the pushing stroke over your line, the highlighted section w ill bereshaped in one direction or the other.
The default overlay colour is light yellow . If this colour is difficult to see
because of the background or draw ing colour, you can adjust the colour.

ColourYou can change the colour of the temporary strokes that appear in thedraw ing space w hen using the Line Pushing Mode or the Auto Adjust

161

Chapter 2: Tools Properties

Icon

Property

Description

Thickness option by clicking on the Colour sw atch and selecting a newcolour in the Colour Picker dialog.

Pencil Properties Dialog
Pencils have extra parameters w hich are not accessible from the Tool Properties view . To open the Pencil
Properties dialog, click on the arrow button right of the stroke display area.

Size and Smoothness Tab
The Size and Smoothness tab allow s you to select your pencil's size, its smoothing parameters as w ell as theshape of its tips and corners.

Property

Description

Maximum Size

Defines the maximum size of the pencil line. If the tool is used w ith a pressure
sensitive pen tablet, the w idth of the stroke w ill vary betw een its maximum size andminimum size depending on the amount of pressure used. If used w ith a mouse, thew idth of the stroke w ill alw ays be its maximum size.

162Harmony 22 Paint Reference Guide

Property

Description

Minimum Size

Defines the minimum size of your stroke as a percentage of the maximum size. If you
do not have pressure sensitivity from a pen table, the minimum size value w ill beignored.

Proportional to Camera

If you check this option, the size of the pencil w ill be adjusted to the position of thecamera on the z-axis. This means that if the camera is zoomed in on the scene, thepencil w ill be proportionally smaller so that it appears the same size in the rendered
image. Likew ise, if the camera is zoomed out, the pencil w ill be proportionally bigger.

Centerline Smoothing

Defines the amount of smoothing Harmony should perform on the central line of thepencil stroke. A higher setting w ill prevent your line from being shaky and w ill reduce
the amount of control points it has, making it easier to tw eak, but is liable to reducedraw ing precision and turn sharp angles into curves.

Defines the amount of smoothing Harmony should perform on the outer contour ofthe pencil stroke.

Contour Smoothing

A pencil line is defined by its centreline and its variations in thickness, rather than its
apparent shape. W hen draw ing a pencil line w ith a mouse, its thickness is uniform.
Therefore, its outer contour does not have any control point, except at its extremities,
and no smoothing is required for its contour.
How ever, w hen draw ing a pencil line w ith a pressure sensitive tablet, its contour w ill
have control points and Bezier curves to define the line's variations in thickness, andthus smoothing must be performed on its contour. An increased contour smoothing
w ill reduce the amount of control points on the line's thickness and smoothen its
curves, but may affect the precision of the variations in line thickness.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew .
You can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You canchoose betw een Round, Mitre and Bevel style.

163

Chapter 2: Tools Properties

Texture Tab
In the Pencil Properties view , the Texture tab allow s you to select a pencil texture from the currently selected
pencil texture palette to use w ith the Pencil tool. You can also add, remove or rename textures, save thecurrent pencil texture palette as the default one, or import the pencil texture palette into your scene.
The pencil texture palette used in the Texture tab of the Pencil Properties dialog is the one selected in the
Colour view . You can select a pencil texture palette by selecting it from the pencil texture palette list in the
Colour view —see Colour View on page 239.

Icon

Property

Description

This option is available from the menu
Use as Default Pencil
Texture Palette

Reload Default Texture
PaletteNew Texture

button. Sets the currently

selected pencil texture palette as the default pencil texture palette inyour user preferences. The default pencil texture palette is added toevery scene you create in Harmony. The palette is copied in yourpreferences, so it w ill be added to your new scenes in the exact state it
is w hen you make it the default pencil texture palette.

Imports the default pencil texture palette as a new pencil texture
palette into your scene's palette list, and selects it as the current pencil
texture palette.

Allow s you to import an image file into a new pencil texture sw atch inthe current pencil texture palette. The pencil texture's effect on yourpencil line w ill be based on the image's transparency channel, and w illfollow your pencil lines on its horizontal axis. This option is alsoavailable from the menu

164

button.

Harmony 22 Paint Reference Guide

Icon

Property

Delete Texture

Rename Texture

Pencil Texture Display

Pencil Texture Palette

Description

Deletes a pencil texture sw atch from the current pencil texture palette.
This option is also available from the menu

button.

Renames the selected pencil texture sw atch in the current pencil
texture palette. This option is also available from the menu

button.

Displays the pencil textures in the current pencil texture palette andallow s you to select one to use w ith the Pencil tool.

Displays the name of the currently selected pencil texture palette, forreference. To select a different pencil texture palette, you must select itin the Colour view —see Colour View on page 239.

165

Chapter 2: Tools Properties

Pencil Editor Tool Properties
W hen you select the Pencil Editor tool, its properties and options appear in the Tool Properties view .

Icon

Tool Name

Description

Allow s you to choose the method to visually select multiple elements:lLasso: Allow s you to select multiple elements by draw ing
an irregular closed shape around them w ith your mouse.

Selection ModelMarquee: Allow s you to select multiple elements bydraw ing a rectangle around them. This is faster, as you only
need to drag your mouse from one corner of the rectangle to its
opposite corner, but it may not be as precise as you w ant.

166

Harmony 22 Paint Reference Guide

TIP
You can press and hold the Alt key to temporarily use the otherselection mode.

This option allow s you to select w hich layers the tool should affect. It
can be toggled on or off. W hen toggled on, it has tw o different modes.
You can select a mode by clicking and holding on the button.
l

Off: W hen this button is toggled off, the tool only w orks on thecurrently selected layers. If several layers are selected, the tool
w ill w ork on all these layers simultaneously.

Apply to Visible Draw ing
Layersl

On W hen this button is toggled on, the tool w ill w ork on all thevisible layers.

l

Apply to Visible Drawing Layers: The tool w ill w ork on all
the visible layers in the Camera view .

lApply to Synced Drawing Layers: If the currently selected
layer is synced w ith another layer, the tool w ill w ork on boththe current layer and its synced layer.

NOTE
This option only w orks in the Camera view .

Defines the maximum w idth of the pencil line.
Maximum Size

Minimum Size

If the pencil line has a constant size, this w ill define the w idth of thepencil line all over. If the pencil line has a varying size, this w ill define
the w idth of its larger areas. Areas that are in-betw een the maximum
and minimum size w ill be resized proportionally.

Defines the minimum w idth of the pencil line. If the pencil line has avarying size, this w ill define the w idth of its smaller areas. Areas thatare in-betw en the maximum and minimum size w ill be resized
proportionally.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first167

Chapter 2: Tools Properties

tip you drew . You can choose betw een Round or Flat style.
lEnd: Lets you select the style of the end tip, w hich is the last tip
you drew . You can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here theline curves abruptly. You could also define the Join style as thecorner style. You can choose betw een Round, Mitre and Bevel
style.

Harmony provides a variety of pencil presets and thickness stencils
and also lets you create and save your ow n. It is a good idea to createand save pencils w ith precise sizes and parameters w hen you draw for
efficiency and consistency.

Presets

A thickness stencil saves the thickness information across the lengthof the line. W hen draw ing w ith a thickness stencil, the pressure
sensitivity of the tablet is discarded. A thickness stencil can be used
w hile draw ing, or applied afterw ards.
You also have the possibility to apply different textures to your lines byeither using the default presets or to import your ow n.
You can export the pencil presets that you have created and importthose that others have created. This is a good w ay for you and project
collaborators to keep a consistent look for the project.

New Brush

Allow s to create a new preset from the selected pencil line.

Delete Brush

Deletes the currently selected preset.

Rename Brush

Allow s you to rename the currently selected preset.

Small Thumbnail, Large
Thumbnail, and Stroke
View

Allow s you to display the presets as small square thumbnails, large
square thumbnails or a list of stroke preview .

This option is available from the menu
Use as Default Pencil
Texture Palette

Reload Default Texture
Palettebutton. Sets the currently

selected pencil texture palette as the default pencil texture palette inyour user preferences. The default pencil texture palette is added toevery scene you create in Harmony. The palette is copied in yourpreferences, so it w ill be added to your new scenes in the exact state it
is w hen you make it the default pencil texture palette.

Imports the default pencil texture palette as a new pencil texture
palette into your scene's palette list, and selects it as the current pencil

168

Harmony 22 Paint Reference Guide

texture palette.

New Texture

Adds a new custom pencil texture to the list.

Delete Texture

Deletes a texture preset from the list.

Rename Texture

Renames the selected texture to keep the list organized.

Presets

Harmony provides a variety of pencil texture presets and also lets you
create and save your ow n.

Pencil Texture Palette

Displays the colour palette assigned to hold the pencil textures. Use
the Colour View menu to assign a new palette.

The Smooth operation lets you smooth out selected draw ing strokes
and remove extra points.

Smooth Selection

TIP
You can also smooth the selection by selecting Selected >Smooth from the top menu or by pressing Alt + Shift + S.

The Pump Pencil Pressure option is used to increase the line thicknessof a selected area on a pencil line.

Pump Pencil Pressure

Deflate Pencil Pressure

The Deflate Pencil Pressure option is used to decrease the line
thickness of a selected area on a pencil line.

169Chapter 2: Tools Properties

Because pencil lines are defined by their centre lines, tw o pencil linesthat brush against each other may not actually make a closed shape,even if they appear closed. If you select several pencil lines that areclose together, you can use this button to close the small gaps
betw een these pencil lines and make them into a single pencil line.
Merge Pencil Lines

The Reverse Pencil Thickness option inverts the thick and thin section
on a selected pencil line. This option w ill take the thickest size on theline and apply it to the thinnest, and it w ill apply the thinnest to thethickest.

Reverse Pencil Thickness170Harmony 22 Paint Reference Guide

Perspective Tool Properties
The perspective tool allow s you to deform artw ork by creating a rectangular bounding box around it andallow ing you to manipulate any of the four corners. The selected artw ork w ill be deformed to fit the shape you
make by simulating a perspective effect.

How to access the Perspective tool properties
1. In the Tools toolbar, select the Perspectivetool.

The tool's properties are displayed in the Tool Properties view .

Icon

Tool Name

Description

Perspective Tool Options

Allow s you to choose the method to visually select multiple elements:lLasso: Allow s you to select multiple elements by draw ing
an irregular closed shape around them w ith your mouse.

lSelection Mode

Marquee: Allow s you to select multiple elements bydraw ing a rectangle around them. This is faster, as you only
need to drag your mouse from one corner of the rectangle toits opposite corner, but it may not be as precise as you w ant.

TIP
You can press and hold the Alt key to temporarily use the otherselection mode.

Snapping

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as toselect w hich types of snapping are enabled.
If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You can also

171

Chapter 2: Tools Properties

Icon

Tool Name

Description

click on this button to toggle it off, w hich w ill disable all snapping
modes, and click on it again and toggle it on to re-enable the snapping
modes w hich w ere previously enabled.
This tool supports the follow ing snapping modes:lSnap to Contour: W hile moving the selection or one of its
control points, it w ill snap against the nearby points andcontours of your artw ork, allow ing you to snap parts of yourartw ork together.

lSnap to Alignment Guides: W hile moving the selection or oneof its control points, it w ill snap against nearby alignment
guides.

lSnap and Align: W hen enabled, w hile moving a selection, therectangular bounding box of the selection w ill snap to therectangular bounding box of any other draw ing stroke in thedraw ing, allow ing you to align draw ing strokes laterally.

lSnap to Grid: W hile moving the selection, the mouse cursor
w ill snap against the intersecting points of the grid.

TIP
To display the grid, select View > Grid > Show Gridfrom the top menu or press Ctrl + '.

Allow s you to perform draw ing operations on both the Line Art andColour Art layers of your draw ing simultaneously.
Apply to Line and Colour
Art

NOTE
If you have Overlay and Underlay Art layers enabled, they w illalso be affected w hen this option is enabled.

Allow s you to select betw een one of the tw o follow ing deformation
modes:l

Perspective: Deforms the selection by simulating aperspective effect.

Deformation ModelLattice: Deforms the selection by simply making theartw ork fit the bounding box, w ithout applying a perspective
effect.

The difference betw een both modes becomes easier to understand if

172

Harmony 22 Paint Reference Guide

Icon

Tool Name

Description

you apply a transformation to a draw ing of a grid to make it look likeit's laid dow n on a surface:

Operations

Flip Horizontal

Flips the selection horizontally.

Flip Vertical

Flips the selection vertically.

Rotate 90 CW

Rotates the selection 90° clockw ise.

Rotate 90 CCW

Rotates the selection 90° counterclockw ise.

173

Chapter 2: Tools Properties

Polyline Tool Properties
The Polyline tool allow s you to draw complex lines or shapes by defining each point and their Bezier handles
one by one.

How to access the Polyline tool properties
1. In the Tools toolbar, select the Polyline

tool.

The tool's properties are displayed in the Tool Properties view .

Pencil Properties
Just like other shape tools, this tool creates pencil lines. Hence, its tool properties are similar to the ones of thePencil tool and it can be used w ith pencil presets.
Icon

Property

Description

The Preview area lets you see a preview of the stroke your draw ing tool
w ill make.
Preview Area

174

Harmony 22 Paint Reference Guide

The arrow button right of the preview area opens the Pencil Properties
dialog.

Pencil Properties
DialogW hile the Tool Properties view only gives you access to the pencil size,
a list of pencil presets and other draw ing options, the Pencil Properties
dialog gives you access to all the available options for your pencil's
shape and texture. For more information on the Pencil Properties dialog,
see the Polyline Tool Properties section below .

SizeDefines the w idth of the pencil line used to draw the shape.

Pencil Presets
Icon

Property

Description

Presets list

Harmony provides a variety of presets and also lets you create and saveyour ow n. It is a good idea to create and save pencils w ith precise sizes
and parameters w hen you draw and design for efficiency andconsistency.
All tools using pencil lines share the same preset list. Therefore, thePolyline, Line, Rectangle, Ellipse, and Pencil tools share the same preset
list.

New Preset

Creates a new preset based on the current tool properties.

Delete Preset

Deletes the currently selected preset.

Presets Menu

Gives access to more options for managing presets.

Rename Brush

Allow s you to rename the currently selected preset.

Import Brushes

Allow s you to import brush presets exported from Harmony.

Export Brushes

Allow s you to export your brush presets into an .xml file.

Small Thumbnail

Displays presets in a grid of small thumbnails w ith a preview of their tip.

175

Chapter 2: Tools Properties

Large Thumbnail

Displays presets in a grid of big thumbnails, w ith their name and apreview of their tip.

Stroke View

Displays presets in a list, w ith their name and a preview of a stroke done
w ith each preset.

Drawing Options
Icon

Property

Description

W hen this option is enabled, clicking close to a contour in your draw ing
w ill add the point to that contour. The line you are building w ill be linked
to that contour.

Snap to Contour

If this option is disabled, attempting to click on existing contours w ill
alw ays create a point very close to that contour, but not exactly on it.
Therefore, it is necessary to enable this mode if you w ant to create linesthat branch from into existing contours in your draw ing.

NOTE
If you draw a line w ith the Line tool and make its tip snap to acontour or another control point in your artw ork, they w ill belocked together. You can then manipulate both simultaneously
using theContour Editor tool. You can also separate tw o

draw ing strokes that have been snapped together by selecting
one of them w ith theSelect tool and moving it aw ay.

W hen enabled, draw ing a closed shape w ill automatically fill it w ith thecurrently selected Paint colour.

Auto Fill

176

Harmony 22 Paint Reference Guide

TIP
By default the pencil line and its fill w ill be the same colour. To
select different colours for the line and its fill, do the follow ing:
1. In the Colour view , click the
2. Click on the

Unlock Three Colours button.

Set Current Pencil Colour sw atch. Then, inthe colour list, select the desired colour sw atch for youroutline.
3. Click on the

Set Current Paint Colour sw atch. Then, in thecolour list, select the desired colour sw atch for the fill.

W hen enabled, draw ing a closed shape w ill automatically remove theoutstanding lines.
Trim Extra Lines

W hen the Trim Extra Lines option is enabled, enable this option to makethe point w here the beginning and end of the stroke meet into a smooth
curve rather than a hard corner.
Align Handles AfterTrim

As you draw in the Line Art layer, the Automatically Create Colour Art
option instantly creates the corresponding strokes in the Colour Art
layer.
Automatically Create
Colour Art

Auto-Flatten Mode

By default, w hen draw ing on a vector layer, each new stroke is createdas a separate draw ing object, w hich can be edited independently fromother parts of the artw ork. W hen enabled, the Auto-Flatten option
automatically merges strokes into existing artw ork.

177

Chapter 2: Tools Properties

NOTE
Using the Select tool, you can use select and remove a segment offlattened pencil lines. Overlapping pencil lines draw n w ith theAuto-Flatten mode are essentially cut into segments by theoverlap and can be treated as individual lines.

Pencil Properties Dialog
The Polyline tool draw s the same type of line as the Pencil tool. Hence, you can configure the Polyline tool'slines using the Pencil Properties dialog, w hich you can open by clicking on the arrow button right of the stroke
display area in the Tool Properties view .

Size and Smoothness Tab
The Size and Smoothness tab allow s you to select your pencil's size, its smoothing parameters as w ell as theshape of its tips and corners.

178

Harmony 22 Paint Reference Guide

Property

Description

Maximum Size

Defines the maximum size of the pencil line. If the tool is used w ith a pressure
sensitive pen tablet, the w idth of the stroke w ill vary betw een its maximum size andminimum size depending on the amount of pressure used. If used w ith a mouse, thew idth of the stroke w ill alw ays be its maximum size.

Minimum Size

Defines the minimum size of your stroke as a percentage of the maximum size. If you
do not have pressure sensitivity from a pen table, the minimum size value w ill beignored.

Proportional to Camera

If you check this option, the size of the pencil w ill be adjusted to the position of thecamera on the z-axis. This means that if the camera is zoomed in on the scene, thepencil w ill be proportionally smaller so that it appears the same size in the rendered
image. Likew ise, if the camera is zoomed out, the pencil w ill be proportionally bigger.

Centerline Smoothing

Defines the amount of smoothing Harmony should perform on the central line of thepencil stroke. A higher setting w ill prevent your line from being shaky and w ill reduce
the amount of control points it has, making it easier to tw eak, but is liable to reducedraw ing precision and turn sharp angles into curves.

Defines the amount of smoothing Harmony should perform on the outer contour ofthe pencil stroke.

Contour Smoothing

A pencil line is defined by its centreline and its variations in thickness, rather than its
apparent shape. W hen draw ing a pencil line w ith a mouse, its thickness is uniform.
Therefore, its outer contour does not have any control point, except at its extremities,
and no smoothing is required for its contour.
How ever, w hen draw ing a pencil line w ith a pressure sensitive tablet, its contour w ill
have control points and Bezier curves to define the line's variations in thickness, andthus smoothing must be performed on its contour. An increased contour smoothing
w ill reduce the amount of control points on the line's thickness and smoothen its
curves, but may affect the precision of the variations in line thickness.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew .

179

Chapter 2: Tools Properties

Property

Description

You can choose betw een Round or Flat style.
lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You canchoose betw een Round, Mitre and Bevel style.

Texture Tab
In the Pencil Properties view , the Texture tab allow s you to select a pencil texture from the currently selected
pencil texture palette to use w ith the Pencil tool. You can also add, remove or rename textures, save thecurrent pencil texture palette as the default one, or import the pencil texture palette into your scene.
The pencil texture palette used in the Texture tab of the Pencil Properties dialog is the one selected in the
Colour view . You can select a pencil texture palette by selecting it from the pencil texture palette list in the
Colour view —see Colour View on page 239.

Icon

Property

Description

This option is available from the menu
Use as Default Pencil
Texture Palettebutton. Sets the currently

selected pencil texture palette as the default pencil texture palette inyour user preferences. The default pencil texture palette is added toevery scene you create in Harmony. The palette is copied in yourpreferences, so it w ill be added to your new scenes in the exact state it
is w hen you make it the default pencil texture palette.

180

Harmony 22 Paint Reference Guide

Icon

Property

Description

Reload Default Texture
PaletteImports the default pencil texture palette as a new pencil texture
palette into your scene's palette list, and selects it as the current pencil
texture palette.

New Texture

Allow s you to import an image file into a new pencil texture sw atch inthe current pencil texture palette. The pencil texture's effect on yourpencil line w ill be based on the image's transparency channel, and w illfollow your pencil lines on its horizontal axis. This option is alsoavailable from the menu

Delete Texture

Rename Texture

button.

Deletes a pencil texture sw atch from the current pencil texture palette.
This option is also available from the menu

button.

Renames the selected pencil texture sw atch in the current pencil
texture palette. This option is also available from the menu

button.

Pencil Texture Display

Displays the pencil textures in the current pencil texture palette andallow s you to select one to use w ith the Pencil tool.

Pencil Texture Palette

Displays the name of the currently selected pencil texture palette, forreference. To select a different pencil texture palette, you must select itin the Colour view —see Colour View on page 239.

181

Chapter 2: Tools Properties

Rectangle Tool Properties
The Rectangle tool allow s you to quickly draw a rectangle or a square.

How to access the Rectangle tool properties
1. In the Tools toolbar, select the Rectangle

tool.

The tool's properties are displayed in the Tool Properties view .

Pencil Properties
Just like other shape tools, this tool creates pencil lines. Hence, its tool properties are similar to the ones of thePencil tool and it can be used w ith pencil presets.
Property

Description

The Preview area lets you see a preview of the stroke your draw ing tool w ill make.
Preview Area

Pencil Properties
Dialog

The arrow button right of the preview area opens the Pencil Properties dialog.

182

Harmony 22 Paint Reference Guide

Property

Description

W hile the Tool Properties view only gives you access to a few of the pencil properties,
a list of pencil presets and other draw ing options, the Pencil Properties dialog gives youaccess to all the available options for your pencil's shape and texture. For more
information on the Pencil Properties dialog, see the Pencil Properties Dialog on page
187 section below .

SizeDefines the w idth of the pencil line used to draw the shape.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew . You
can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You can choose
betw een Round, Mitre and Bevel style.

Drawing Options
These options affect the w ay your shape is added to your artw ork.
Icon

Property

Description

Draw Behind

W hen enabled, your brush strokes w ill appear behind the existingartw ork.

183

Chapter 2: Tools Properties

Icon

Property

Description

NOTEYour brush stroke w ill temporarily appear over your artw ork as
you draw it, until you release the mouse cursor or tablet pen.

W hen enabled, the shape you draw is automatically filled w ith theselected colour. By default, draw ing a shape only creates its outlines.

Auto Fill

TIP
By default the pencil line and its fill w ill be the same colour. To
select different colours for the line and its fill, do the follow ing:
1. In the Colour view , click the
2. Click on the

Unlock Three Colours button.

Set Current Pencil Colour sw atch. Then, inthe colour list, select the desired colour sw atch for youroutline.
3. Click on the

Set Current Paint Colour sw atch. Then, in thecolour list, select the desired colour sw atch for the fill.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as to selectw hich types of snapping are enabled.

Snapping

If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You can also
click on this button to toggle it off, w hich w ill disable all snapping
modes, and click on it again and toggle it on to re-enable the snapping
modes w hich w ere previously enabled.
This tool supports the follow ing snapping modes:

184Harmony 22 Paint Reference Guide

Icon

Property

DescriptionlSnap to Contour: W hen enabled, w hile you're draw ing, themouse cursor w ill snap to the nearby contours of the artw ork inyour draw ing.

lSnap to Alignment Guides: W hile draw ing, the draw ing tool
w ill snap against nearby alignment guides.

lSnap and Align: W hen enabled, w hile you're draw ing, themouse cursor w ill automatically align to the rectangularbounding boxes of other strokes and shapes in your draw ing.

l

W hen enabled, w hile you're draw ing, the mouse cursor w ill snap
against the intersecting points of the grid.

TIP
To display the grid, select View > Grid > Show Grid fromthe top menu or press Ctrl + '.

As you draw in the Line Art layer, the Automatically Create Colour Art
option instantly creates the corresponding strokes in the Colour Art
layer.
Automatically Create
Colour Art

By default, w hen draw ing on a vector layer, each new stroke is createdas a separate draw ing object, w hich can be edited independently fromother parts of the artw ork. W hen enabled, the Auto-Flatten option
automatically merges strokes into existing artw ork.
Auto Flatten Mode

185

Chapter 2: Tools Properties

Icon

Property

Description

NOTE
Using the Select tool, you can use select and remove a segment offlattened pencil lines. Overlapping pencil lines draw n w ith theAuto-Flatten mode are essentially cut into segments by theoverlap and can be treated as individual lines.

Use Stored Colour
Gradient

The Use Stored Colour Gradient option can be used w hen painting w ith
a gradient colour to alw ays position the gradient in the same w ay it w asstored, making it consistent across brush strokes. You can store a
gradient by selecting a zone painted w ith a gradient w ith the Select tool,
then clicking on Store Colour Gradientin the Tool Properties view .

W hen enabled, the rectangle tool w ill alw ays draw a rectangle of equal
w idth and height, making it a perfect square.
Draw Square

TIP
You can also draw a perfect square by holding the Shift key w hiledraw ing.

Pencil Presets
These options allow you to select, create and manage pencil presets.
Icon

Property

Description

Harmony provides a variety of pencil presets and thickness stencils andalso lets you create and save your ow n. It is a good idea to create andsave pencils w ith precise sizes and parameters w hen you draw for
efficiency and consistency.

Presets list

A thickness stencil saves the thickness information across the length ofthe line. W hen draw ing w ith a thickness stencil, the pressure sensitivityof the tablet is discarded. A thickness stencil can be used w hile draw ing,
or applied afterw ards.
You also have the possibility to apply different textures to your lines byeither using the default presets or to import your ow n.
You can export the pencil presets that you have created and importthose that others have created. This is a good w ay for you and project
collaborators to keep a consistent look for the project.

186

Harmony 22 Paint Reference Guide

Icon

Property

Description

New Brush Preset

Creates a new preset based on the current tool properties.

Delete Brush Preset

Deletes the currently selected preset.

Open a menu that contains the follow ing options:l

New Brush Preset: Creates a new preset based on the current
tool properties.

lDelete Brush: Deletes the currently selected preset.

lRename Brush: Allow s you to rename the currently selected
preset.

lImport Brushes: Allow s you to import brush presets exported
from Harmony.

l

Export Brushes: Allow s you to export your brush presets into an.xml file.

l

Small Thumbnail: Displays presets in a grid of small thumbnails
w ith a preview of their tip.

lLarge Thumbnail: Displays presets in a grid of big thumbnails,

Brush Presets Menu

w ith their name and a preview of their tip.
lStroke View: Displays presets in a list, w ith their name and apreview of a stroke done w ith each preset.

Pencil Properties Dialog
The Rectangle tool draw s the same type of line as the Pencil tool. Hence, you can configure the Rectangle
tool's lines using the Pencil Properties dialog, w hich you can open by clicking on the arrow button right of thestroke display area in the Tool Properties view .

Size and Smoothness Tab
The Size and Smoothness tab allow s you to select your pencil's size, its smoothing parameters as w ell as theshape of its tips and corners.

187

Chapter 2: Tools Properties

Property

Description

Maximum Size

Defines the maximum size of the pencil line. If the tool is used w ith a pressure
sensitive pen tablet, the w idth of the stroke w ill vary betw een its maximum size andminimum size depending on the amount of pressure used. If used w ith a mouse, thew idth of the stroke w ill alw ays be its maximum size.

Minimum Size

Defines the minimum size of your stroke as a percentage of the maximum size. If you
do not have pressure sensitivity from a pen table, the minimum size value w ill beignored.

Proportional to Camera

If you check this option, the size of the pencil w ill be adjusted to the position of thecamera on the z-axis. This means that if the camera is zoomed in on the scene, thepencil w ill be proportionally smaller so that it appears the same size in the rendered
image. Likew ise, if the camera is zoomed out, the pencil w ill be proportionally bigger.

Centerline Smoothing

Defines the amount of smoothing Harmony should perform on the central line of thepencil stroke. A higher setting w ill prevent your line from being shaky and w ill reduce
the amount of control points it has, making it easier to tw eak, but is liable to reducedraw ing precision and turn sharp angles into curves.

Defines the amount of smoothing Harmony should perform on the outer contour ofthe pencil stroke.

Contour Smoothing

A pencil line is defined by its centreline and its variations in thickness, rather than its
apparent shape. W hen draw ing a pencil line w ith a mouse, its thickness is uniform.
Therefore, its outer contour does not have any control point, except at its extremities,
and no smoothing is required for its contour.
How ever, w hen draw ing a pencil line w ith a pressure sensitive tablet, its contour w ill
have control points and Bezier curves to define the line's variations in thickness, and188

Harmony 22 Paint Reference Guide

Property

Description

thus smoothing must be performed on its contour. An increased contour smoothing
w ill reduce the amount of control points on the line's thickness and smoothen its
curves, but may affect the precision of the variations in line thickness.

You can adjust the start, end, and join style of a pencil line.

Shape

l

Start: Lets you select the style of the start tip, w hich is the first tip you drew .
You can choose betw een Round or Flat style.

lEnd: Lets you select the style of the end tip, w hich is the last tip you drew .
You can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here the line curves
abruptly. You could also define the Join style as the corner style. You canchoose betw een Round, Mitre and Bevel style.

Texture Tab
In the Pencil Properties view , the Texture tab allow s you to select a pencil texture from the currently selected
pencil texture palette to use w ith the Pencil tool. You can also add, remove or rename textures, save thecurrent pencil texture palette as the default one, or import the pencil texture palette into your scene.
The pencil texture palette used in the Texture tab of the Pencil Properties dialog is the one selected in the
Colour view . You can select a pencil texture palette by selecting it from the pencil texture palette list in the
Colour view —see Colour View on page 239.

189

Chapter 2: Tools Properties

Icon

Property

Description

This option is available from the menu
Use as Default Pencil
Texture Palettebutton. Sets the currently

selected pencil texture palette as the default pencil texture palette inyour user preferences. The default pencil texture palette is added toevery scene you create in Harmony. The palette is copied in yourpreferences, so it w ill be added to your new scenes in the exact state it
is w hen you make it the default pencil texture palette.

Reload Default Texture
PaletteNew Texture

Imports the default pencil texture palette as a new pencil texture
palette into your scene's palette list, and selects it as the current pencil
texture palette.

Allow s you to import an image file into a new pencil texture sw atch inthe current pencil texture palette. The pencil texture's effect on yourpencil line w ill be based on the image's transparency channel, and w illfollow your pencil lines on its horizontal axis. This option is alsoavailable from the menu

Delete Texture

Rename Texture

Pencil Texture Display

button.

Deletes a pencil texture sw atch from the current pencil texture palette.
This option is also available from the menu

button.

Renames the selected pencil texture sw atch in the current pencil
texture palette. This option is also available from the menu

button.

Displays the pencil textures in the current pencil texture palette and190

Harmony 22 Paint Reference Guide

Icon

Property

Description

allow s you to select one to use w ith the Pencil tool.

Pencil Texture Palette

Displays the name of the currently selected pencil texture palette, forreference. To select a different pencil texture palette, you must select itin the Colour view —see Colour View on page 239.

191

Chapter 2: Tools Properties

Reposition All Drawings Tool Properties
W hen you use the Reposition All Draw ings tool, its properties and options appear in the Tool Properties view .

Tool Options
Icon

OptionDescription

Easy Drag

W hen enabled, you can drag the selection by clicking anyw here inside its
bounding box. By default, you must click on the artw ork in the selection to beable to drag it.

Apply toSyncedIf the currently selected layer is synced w ith another layer, the tool w ill w ork on

Draw ing Layers

both the current layer and its synced layer.

Operations
Icon

OptionDescription

Flip Horizontal

Flips the current selection horizontally.

Flip Vertical

Flips the current selection vertically.

Rotate 90
Degrees CW

Rotates the current selection 90 degrees clockw ise.

Rotate 90
Degrees CCW

Rotates the current selection 90 degrees counter-clockw ise.

Offset X and Y

Use the Offset X and Offset Y operation fields to enter specific values andprecisely reposition the selected shape.

192

Harmony 22 Paint Reference Guide

Icon

OptionDescription

1. X: Type a value in this field to reposition your selection along the Xaxis.
2. Y: Type a value in this field to reposition your selection along the Yaxis.
3. Up/Down arrows: Use the up and dow n arrow s to modify the value in
the X or Y value field.

Use the W idth and Height operation fields to enter specific values to resize
the selected shape w ith precision.

W idth and Height
1. W idth: Type a value in this field to resize the w idth of your selection.
2. Height: Type a value in this field to resize the height of your selection.
3. Up/Down arrows: Use the up and dow n arrow s to modify the value in
the W idth or Height fields.
4. Lock icon: Click the lock icon to lock or unlock the ratio betw een the
W idth and Height values.

The Angle operation lets you to enter specific values and accurately rotate theselected shape.

Angle
1. Angle: Type a degree value in this field to rotate your selection.
2. Up/Down arrows: Use the up and dow n arrow s to modify the value in
the Angle value field.

193

Chapter 2: Tools Properties

Select Tool Properties
The Select tool lets you select strokes and apply basic transformations such as repositioning, rotating, scalingor skew ing, using the different handles of the bounding box.
If you have text or pencil lines selected w ith the Select tool, their properties w ill display in the Tool Properties
view , allow ing you to make changes to your selection.

How to access the Select tool properties
1. In the Tools toolbar, select either the Selecttool or the Select by Colour

tool.

The tool's properties are displayed in the Tool Properties view .

NOTE
Selecting the Select by Colour

tool from the Tools toolbar activates the Select tool, w ith theSelect by Colour option enabled. Hence, this topic covers the tool properties for both the Selectand Select by Colour tools.

194

Harmony 22 Paint Reference Guide

Tool Options
Icon

Property

Description

Allow s you to choose the method to visually select multiple
elements:lLasso: Allow s you to select multiple elements bydraw ing an irregular closed shape around them w ith yourmouse.

lMarquee: Allow s you to select multiple elements bydraw ing a rectangle around them. This is faster, as you only
need to drag your mouse from one corner of the rectangle toits opposite corner, but it may not be as precise as you w ant.

Selection ModeTIP
You can press and hold the Alt key to temporarily use theother selection mode.

Easy Drag

W hen enabled, you can drag the selection by clicking anyw here
inside its bounding box. By default, you must click on the artw ork inthe selection to be able to drag it.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as toselect w hich types of snapping are enabled.
If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You canalso click on this button to toggle it off, w hich w ill disable allsnapping modes, and click on it again and toggle it on to re-enable
the snapping modes w hich w ere previously enabled.
This tool supports the follow ing snapping modes:
SnappinglSnap to Contour: W hile moving the selection or one of its
control points, it w ill snap against the nearby points andcontours of your artw ork, allow ing you to snap parts of yourartw ork together.

lSnap to Alignment Guides: W hile moving the selection or
one of its control points, it w ill snap against nearbyalignment guides.

lSnap and Align: W hile moving the selection, the rectangularbounding box of the selection w ill align w ith the rectangularbounding boxes of other strokes and shapes in your artw ork.

195

Chapter 2: Tools Properties

Icon

Property

Description

If you move one of your selection's control points, it w ill alsoalign w ith the bounding boxes of other strokes and shapes inyour artw ork.

lSnap to Grid: W hile moving the selection, the mouse cursor
w ill snap against the intersecting points of the grid.

TIP
To display the grid, select View > Grid > Show Gridfrom the top menu or press Ctrl + '.

W hen enabled, the w idth of pencil lines w ill be adjusted w hen
scaling them w ith the Select tool.
Scale Pencil Line
Thickness

TIP
You can quickly enable this mode by selecting the Scale
Pencil Line Thickness

tool, in the Selecttool'sproperties dialog.

Select by Colour

W hen enabled, clicking on a coloured zone in your artw ork w ill
instantly select all the zones that are filled w ith the same colour.
Select by Colour

196

can also be accessed from the Tools toolbar.

Harmony 22 Paint Reference Guide

Icon

Property

Description

NOTE
Only the zones painted w ith the same colour swatch in yourpalette w ill be selected. If another zone is coloured w ith theexact same colour, but not the same colour sw atch, it w ill not
be selected.

Allow s you maintain a selection w hile editing multiple draw ings.
Once this option is enabled, the selection zone made using the
Select tool w ill remain as you navigate through draw ings of thesame layer and draw ings from other draw ing layers.

Permanent Selection

This option allow s you to select w hich layers the tool should affect.
It can be toggled on or off. W hen toggled on, it has tw o different
modes. You can select a mode by clicking and holding on the button.
Apply to Visible Draw ing
Layersl

Off: W hen this button is toggled off, the tool only w orks on
the currently selected layers. If several layers are selected,
the tool w ill w ork on all these layers simultaneously.

l

On W hen this button is toggled on, the tool w ill w ork on all

197

Chapter 2: Tools Properties

Icon

Property

Description

the visible layers.
l

Apply to Visible Drawing Layers: The tool w ill w ork on
all the visible layers in the Camera view .

lApply to Synced Drawing Layers: If the currently
selected layer is synced w ith another layer, the tool w ill
w ork on both the current layer and its synced layer.

NOTE
This option only w orks in the Camera view .

This option allow s you to determine w hich draw ings in the current
layer the tool should affect. It can be toggled on or off. W hen
toggled on, it has tw o different modes. You can select a mode byclicking and holding on the button.
l

Apply to All FrameslOff: W hen this button is toggled off, the tool only w orks on
the draw ing in the current frame.
Apply to All Frames: The tool w ill w ork on every
exposed draw ing in the selected layer simultaneously.

lApply to Onion Skin Range: The tool w ill w ork on every
draw ing displayed in the Onion Skin. Onion Skin must be
enabled for this option to w ork.

198

Harmony 22 Paint Reference Guide

Icon

Property

Description

Allow s you to perform draw ing operations on both the Line Art andColour Art layers of your draw ing simultaneously.
Apply to Line and Colour
Art

NOTE
If you have Overlay and Underlay Art layers enabled, theyw ill also be affected w hen this option is enabled.

Operations
Icon

Property

Description

Flip Horizontal

Flips the current selection horizontally.

Flip Vertical

Flips the current selection vertically.

Rotate 90 Degrees CW

Rotates the current selection 90 degrees clockw ise.

Rotate 90 Degrees CCW

Rotates the current selection 90 degrees counter-clockw ise.

Smooth out selected draw ing strokes and remove extra points.

Smooth199

Chapter 2: Tools Properties

Icon

Property

Description

Merges draw ing objects and brush strokes into a single layer. If you
draw new lines to fix a draw ing or line w ith many brush strokes, it
can be useful to flatten them all into a single shape. By default, lines
are draw n one on top of each other. If you intend to repaint the lines
or modify their shape, it w ill be easier if they are flattened.

FlattenCreate Colour Art fromLine Art

Lets you use the outline you traced on one of the four embedded
layers (line art, colour art, overlay, underlay) and create invisible
strokes to paint your draw ings on separate layers. This provides
more inking and painting flexibility.
You can also configure this option to create the invisible strokes on
any of the four embedded layers.

Store Colour Gradient

Use the Store Colour Gradient operation to record the selectedgradient’s position. This reuses the stored position of the gradientw hen draw ing new brush lines or painting colour zones. Enable theUse Stored Colour Gradientoption in the Paint or Brush Tool

Properties view to do this.

Converts the selected centre line pencil strokes into contour strokes
brush lines.

Pencil to Brush

Merge Pencil Lines

Because pencil lines are defined by their centre lines, tw o pencil
lines that brush against each other may not actually make a closed
shape, even if they appear closed. If you select several pencil lines

200Harmony 22 Paint Reference Guide

Icon

Property

Descriptionthat are close together, you can use this button to close the small
gaps betw een these pencil lines and make them into a single pencil
line.

NOTE
Points must be close enough to be merged. If there is a large
gap betw een the lines, they w ill not be merged.

The Reverse Pencil Thickness option inverts the thick and thinsection on a selected pencil line. This option w ill take the thickest
size on the line and apply it to the thinnest, and it w ill apply thethinnest to the thickest.

Reverse Pencil Thickness

Offset X

Lets you enter a value to reposition the selection along the X-axis.

Offset Y

Lets you enter a value to reposition the selection along the Y-axis.

W idthLets you enter a value to resize the w idth of the selection.

201

Chapter 2: Tools Properties

Icon

Property

Description

HeightLets you enter a value to resize the height of the selection.

Lock

Locks or unlocks the ratio betw een the W idth and Height values.

Angle

Lets you enter specific values to rotate the selection. A positive value
rotates the selection counter clockw ise and a negative value rotates
the selection clockw ise.

Pencil Selection
If the selection contains pencil lines, the Pencil Selection section appears at the bottom of the Tool Properties
view , allow ing you to adjust the properties of those pencil lines.

Icon

Property

Description

Maximum Size

Adjusts the size of the parts of the pencil lines that are the thickest.
Parts of the pencil lines that are betw een the minimum andmaximum sizes w ill be adjusted proportionally.

202

Harmony 22 Paint Reference Guide

Icon

Property

Description

Minimum Size

Adjusts the size of the parts of the pencil lines that are the thinnest.
Parts of the pencil lines that are betw een the minimum andmaximum sizes w ill be adjusted proportionally.

You can adjust the start, end, and join style of a pencil line.

lStart: Lets you select the style of the start tip, w hich is thefirst tip you drew . You can choose betw een Round or Flatstyle.

lEnd: Lets you select the style of the end tip, w hich is the last
tip you drew . You can choose betw een Round or Flat style.

lJoin: Lets you select the joint style. The joints are w here theline curves abruptly. You could also define the Join style as
the corner style. You can choose betw een Round, Mitre andBevel style.

Pencil Line Shape

Allow s you to apply one of the available line thickness stencils tothe selected pencil lines. Stencils set the w idth of a pencil lines allalong its length. You can use one of the preloaded presets, or create
your ow n pencil stencils.

Pencil Stencils

Adding Texture to a
Pencil Line

Pencil lines support texture. Once a pencil line is draw n, you canapply a preset texture or load your ow n. Textures are independent
from pencil stencils.

Text Selection
If your selection include text boxes created w ith the Text tool, a Text Selection section w ill appear at thebottom of the Tool Properties view , allow ing you to adjust the formatting of the w hole text box.

203

Chapter 2: Tools Properties

TIP
You can also adjust the formatting of parts of the text in the text box using the Text tool—see Text
Tool Properties on page 222.

Icon

Property

Description

Lets you select the font in w hich to display the text.

Font

Makes the selected text bold.
Bold

Makes the selected text italic.
ItalicAligns the text in the selected text box to the left.

Align Left204

Harmony 22 Paint Reference Guide

Icon

Property

Description

Aligns the text in the selected text box to the centre.

Align Center

Aligns the text in the selected text box to the right.

Align Right

Makes the text in the selected text box take all the horizontal space byadjusting the spacing betw een each w ord. Text that use a single line
and text in the last line of a paragraph is aligned to the left.

Justify

Allow s you to set the size of the selected text.
Size

Kerning

Allow s you to increase or decrease the spacing betw een eachcharacter.

205

Chapter 2: Tools Properties

Icon

Property

Description

Auto Kern

Sets the kerning automatically based on the font’s predefined
standard.

Allow s you to increase or decrease the indentation of the first line oftext in each paragraph.
IndentIncreases or decreases the space betw een each line of text.

Line Spacing

206Harmony 22 Paint Reference Guide

Shift and Trace Tool Properties
The Shift and Trace tool allow s you to temporarily move, rotate and scale draw ings, then trace over them inother draw ings, using Onion Skin to keep the outlines of the shifted draw ings in your draw ing space. Contrary
to Shift and Trace w ith the Draw ing Desk, you can use the Shift and Trace tool in the Camera view .

How to access the Shift and Trace Tool Properties
1. Do one of the follow ing:l

In the Tools toolbar, double-click on the Hand

tool and select Shift and Tracein thepop-up menu.
l

In the top menu, select Drawing > Drawing Tools > Shift and Trace.

The Shift and Trace tool properties appear in the Tool Properties view .

Icon

Tool Name

Description

Shift and Trace Tool Options

Enable/Disable Shiftand Trace

Enabled by default. W hen disabled, draw ings that w ere repositioned,rotated or scaled w ith the Shift and Trace tool appear in their original
position.

Display Cross Hair

Enabled by default. W hen disabled, cross hairs added w ith the Shift andTrace tool are invisible.

Show manipulatorsfor shift and trace

Enabled by default. This displays the manipulator allow ing you to rotateand scale draw ings for Shift and Trace, as w ell as to re-position their pivot

207

Chapter 2: Tools Properties

Icon

Tool Name

Description

point. W hen hidden, you can only shift draw ings laterally.

Show the outline of
the selected shift andtrace draw ing

W hen enabled, the contours of each brush stroke for the current draw ing
w ill appear highlighted in cyan.

Enabled by default. W hen using the Shift and Trace tool, peg holes areShow /Hide Pegs

Peg Position

displayed at the bottom of every draw ing to help keep track of how offset
draw ings are from their original position and from each other. You canalso click and drag on the left or right peg hole of a draw ing to rotate itaround the centre peg hole. W hen disabled, those peg holes are hidden.

Allow s you to select on w hich edge of the draw ings to display peg holes.
By default, they are displayed at the bottom of the draw ings.

Modes and Operations

W hen selected, clicking on the draw ing w ill add a cross hair w here you
click. Cross hairs are marks that appear on the same location on every
Set Add Cross HairModedraw ing in the current layer and w hich move w hen you offset a draw ing
w ith the Shift and Trace tool, and they appear in the Onion Skin renditionof neighbouring draw ings as w ell. This allow s you to keep track of how
offset each draw ing is.

Remove All Cross
Hair

Removes all the cross hairs created for shift and trace.

Reset Selected
Draw ings Shift
Position

Undoes all transformations done w ith the Shift and Trace tool on theselected draw ings, resetting them to their original position, angle andscale.

Reset All Draw ings
Shift Position

Undoes all transformations done w ith the Shift and Trace tool on all
draw ings, resetting them to their original position, angle and scale.

Info

Selected Draw ings

The element name and draw ing name of the currently selected draw ing.

Position

The offset of the current draw ing from its original position on the x and y208

Harmony 22 Paint Reference Guide

Icon

Tool Name

Description

axes, in fields, w hen moved w ith the Shift and Trace tool.

Scale

The Shift and Trace scale factor of the currently selected draw ing, w hen
scaled w ith the Shift and Trace tool.

Rotation

The Shift and Trace rotation angle of the currently selected draw ing, indegrees, counterclockw ise, w hen rotated w ith the Shift and Trace tool.

Pivot

The offset, in fields, of the current draw ing's pivot point from its centre, on
the x and y axes. The pivot point is the point from w hich draw ings arerotated and scaled.

209

Chapter 2: Tools Properties

Smooth Editor Tool Properties
W hen you select the Smooth Editor tool, its properties and options appear in the Tool Properties view .

Icon

Tool Name

Description

The Smoothing Style options allow you to smooth aportion of your draw ing by tracing a smoothing strokeover the zone to optimize or by selecting an area ofthe draw ing w ith the Marquee or Lasso.
Note that by default, the Smooth Editor tool colour isyellow , it w as changed to orange for screen grab
clarity.

Smoothing Style

The Show Control Points option allow s you to showor hide the Bezier points around lines. W hen the
Bezier points are displayed, you can see the result ofyour smoothing and the number of points left on the
curve. W hen it is turned off, only the original artw ork
is displayed.

Show Control Points

This is w here you set the minimum and maximum
sizes of your draw ing tool w hich w ill produce the thickand thin effect on your stroke. This w orks w ith thepressure sensitivity of a pen tablet.

Minimum Size andMaximum Size

This options is available w hile using the Brush
Smoothingl210

style.

Maximum and Minimum Size: Defines the
maximum and minimum w idth of the stroke.

Harmony 22 Paint Reference Guidel

Up/Down arrows: Use the up and dow narrow s to set the minimum and maximum sizevalue.

The Smoothness impacts the strength of thesmoothing result. The higher the value, the morepoints are removed and the smoother the curve. The
Smoothness range is from 0 to 100; the default value
is 20.

Smoothness

You can modify the colour of the control points
displayed on the artw ork w hile w orking w ith the
Smooth Editor tool by double-clicking on the colour
sw atch.

Colour211

Chapter 2: Tools Properties

Stamp Tool Properties
The Stamp tool allow s you to create and use stamps, w hich can contain one or several draw ings that can be
stamped individually or in sequence onto your artw ork.

How to access the Stamp tool properties
1. In the Tools toolbar, select the Stamptool.

The tool's properties are displayed in the Tool Properties view .

Stamp Properties
The follow ing options allow you, among other things, to preview your stamp, to change the size of your stamp
as w ell as to flip it horizontally and vertically.
Property

Description

The Preview area lets you see a preview of w hat w ill appear if you draw a stroke w ith the
Stamp tool.
Preview Area

212

Harmony 22 Paint Reference Guide

Property

Description

The arrow button right of the preview area opens the Stamp Properties dialog.

Stamp Properties
DialogW hile the Tool Properties view only gives you access to a few of the stamp properties and alist of stamp presets, the Stamp Properties dialog gives you access to all the available options
for the w ay your stamp w ill be applied. For more information on the Stamp Properties dialog,
see the Stamp Properties Dialog on page 216 section below .

The tw o-ended arrow s to the left and over the Stamp thumbnail allow you to flip the stamp
horizontally or vertically.
Flip Horizontally/ Flip Vertically

The maximum scaling factor to apply to the stamp before stamping it onto the draw ing.
This setting is a percentage, w hich is relative to the size of the original draw ing that w as used
to create the stamp. This means that, at 100%, the draw ing w ill be stamped into your artw ork
in its original size.

Maximum Scale

NOTE
If the tool is used w ith a pressure sensitive tablet, the scale of the stamp can be made to
be relative to the amount of pressure you put on your pen. To do this, you must reducing
the Minimum Scale property of your stamp in the Stamp Properties dialog. If the
Minimum Scale setting is left at its default value, w hich is 100%, the size of the stamp
w ill not vary.

W hen using a multi-draw ing stamp, this is the number of the draw ing in the series that w ill
be stamped on the next time you use the Stamp tool. For example, if your stamp has 3
draw ings and this is set to 2, the next draw ing that w ill be stamped on is the second draw ing
in the series.
Stamp

If your stamp's Cycle setting is set to Hold, then you have to use this slider to select w hichdraw ing to stamp w ith the Stamp tool.
If your stamp's Reset Cycle for Each Stroke option is enabled, then you can use this slider toselect w hich draw ing to start each stroke w ith.
Otherw ise, w hen you draw a stroke w ith the Stamp tool, the Stamp slider w ill automatically213

Chapter 2: Tools Properties

Property

Description

update to the next draw ing in the sequence.

TIP
You can also cycle through the draw ings in your stamp by using the Left Arrow and Right
Arrow keys.

NOTE
The Cycle and Reset Cycle for Each Strokee options are available in the Stamp
Properties dialog.

Stamp Presets
These options allow you to select, create and manage stamp presets.
Contrary to the Brush and Pencil tools, creating a Stamp preset is required to use the Stamp tool, as thispreset w ill contain the draw ings to stamp onto your artw ork. A Stamp preset is created by selecting one orseveral layers, then adding a preset to the Stamp Presets list. If several layers are selected, the Stamp w ill
contain a series of draw ings, w hich it w ill stamp onto your artw ork in a sequence as you draw strokes w ith the
Stamp tool.
Icon

Property

Description

Presets list

The list of Stamp presets. Click on one of the presets to select it anduse it in your draw ing.

Creates a new Stamp preset based on the selected artw ork. The
artw ork can either be a selection made w ith the Selecttool, or by

selecting a layer.
New Brush Preset

If several layers are selected, this w ill create a multi-draw ing Stamp.
As you draw a stroke w ith the Stamp tool using a multi-draw ing
stamp, each draw ing in the stamp w ill be applied onto your artw ork,
one after the other.

Delete Brush

Deletes the currently selected preset.

Brush Presets Menu

Open a menu that contains all of the previous options, along w ith allof the follow ing options:214Harmony 22 Paint Reference Guidel

New Brush Preset: Creates a new stamp based on theselected artw ork.

lRename Preset:Allow s you to rename the currently selected
preset.

lImport Brushes:Allow s you to import brush presets exported
from Harmony.

l

Export Brushes:Allow s you to export your brush presets into
an .xml file.

l

Small Thumbnail: Displays presets in a grid of small
thumbnails w ith a preview of their tip.

lLarge Thumbnail: Displays presets in a grid of big thumbnails,
w ith their name and a preview of their tip.

lStroke View: Displays presets in a list, w ith their name and apreview of a stroke done w ith each preset.

Drawing Options
These options affect the w ay your draw ing strokes are added to your artw ork
Icon

Property

Description

W hen enabled, your brush strokes w ill appear behind the existingartw ork.

Draw Behind

NOTEYour brush stroke w ill temporarily appear over your artw ork as
you draw it, until you release the mouse cursor or tablet pen.

Allow s you to enable or disable snapping for this tool and all otheranimation and draw ing tools that support snapping, as w ell as to selectw hich types of snapping are enabled.
Snapping
If you double-click or long-click on this button, it w ill open a pop-up
menu in w hich you can toggle different snapping modes. You can also
click on this button to toggle it off, w hich w ill disable all snapping215

Chapter 2: Tools Properties

modes, and click on it again and toggle it on to re-enable the snapping
modes w hich w ere previously enabled.
This tool supports the follow ing snapping mode:lSnap to Alignment Guides: W hile draw ing, the draw ing tool
w ill snap against nearby alignment guides.

Stamp Properties Dialog
The Stamp Properties dialog allow s you to set more specific settings for your stamp, such as pressure
sensitivity, spacing, angle, randomness and, for multi-draw ing stamps, how to cycle through each draw ing inthe stamp. To open the Stamp Properties dialog, click on the arrow button right of the stroke display area.

Property

Description

The maximum scaling factor to apply to the stamp before stamping it onto the draw ing.
Maximum Scale

This setting is a percentage, w hich is relative to the size of the original draw ing that w as
used to create the stamp. This means that, at 100%, the draw ing w ill be stamped into yourartw ork in its original size.

Minimum Scale

The minimum scaling factor to apply to the stamp before stamping it onto your draw ing.

216

Harmony 22 Paint Reference Guide

Property

Description

W hen using the Stamp tool w ith a pressure-sensitive pen tablet, the size of the stamps
applied onto your artw ork w ill vary betw een its Minimum Scale and Maximum Scale
properties, relative to the amount of pressure you apply to the pen.
This setting is relative to the Maximum Scale property. This means that if the Maximum
Scale is set to 50% and the Minimum Scale is set to 50%, the actual scaling factor applied tothe stamp w ill vary betw een 25% and 50%.
This setting is also used w ith the Random Size setting.

The tw o-ended arrow s to the left and over the Stamp thumbnail allow you to flip the stamp
horizontally or vertically.
Flip Horizontally /Flip Vertically

The Roundness and Angle parameters allow you to change the shape and orientation of thestamp.
lRoundness: The vertical scaling to apply to the stamp. Reducing this setting
squashes the stamp vertically, allow ing you to turn round or square stamps into flatstamps.

lRoundness &Angle

Angle: The angle at w hich to rotate the brush tip, counterclockw ise.

NOTE
The squashing is not relative to the angle—if the stamp is rotated, the squashing w ill
still be done relative to the stamp's original orientation.

Spacing

Defines the amount of space betw een each stamp that is applied onto the artw ork. The
larger the value, the greater the space betw een each stamp.

217

Chapter 2: Tools Properties

Property

Description

The percentage of randomness to apply to the size of the stamp. This makes the size of thestamp randomly vary betw een its Maximum Scale and Minimum Scale settings each time itis applied to your artw ork.

Random Size
The greater the value of the Random Size property, the closer to its Minimum Scale the sizeof each stamp can get. For example, if the Random Size setting is set to 50% and the
Minimum Scale is set to 50%, the size of the stamp w ill randomly vary betw een 75% and100% of its Maximum Scale.

The maximum value of randomness to apply to the angle of the stamp. This makes theRandom Angle

Random Spacing

angle of the stamp randomly vary w ithin the range of degrees in this setting, in either
direction, each time it is applied to your artw ork. For example, if the stamp's Angle is set to0°, and the Random Angle is set to 180°, each instance of the stamp w ill be at a random
angle varying betw een -90° and 90°.

The maximum amount of randomness to apply to the spacing of the stamp. Increasing thissetting makes the distance betw een each instance of the stamp vary randomly as you draw
a stroke. At 100%, this makes the distance betw een each stroke vary betw een 0% and200% of its Spacing property.

For multi-draw ing stamps, this decides the logic w ith w hich to cycle through the sequenceof draw ings in the stamp as you draw a stroke.
Cycle

l

Forward: Starts by applying the first draw ing in the sequence, then the next one,and so on until it reaches the last draw ing in the sequence, then cycles back to thefirst one.

218

Harmony 22 Paint Reference Guide

Property

DescriptionlReverse: Starts by applying the last draw ing in the sequence, then the previous one,and so on until it reaches the first draw ing in the sequence, then cycles back to thelast one.

l

Forward- >Reverse: Starts by cycling forw ard through the sequence until it reaches
the last draw ing, then cycles backw ard to the first draw ing, and so on.

lReverse- >Forward: Starts by cycling backw ard through the sequence until itreaches the first draw ing, then cycles back to the last draw ing, and so on.

lRandom: Applies a random draw ing in the sequence each time the stamp is applied.

lHold: Applies a single one of the draw ings in the sequence over and over again.

TIP
W hen this option is set to Hold, you can select w hich one of the draw ings is stamped onby changing the Stamp setting in the Tool Properties view .

For multi-draw ing stamps. This makes it so each stroke you draw w ith the stamp too alw ays
starts w ith the first draw ing in the cycle, w hich is decided by the Stamp option in the Tool
Properties view .
Reset Cycle for
Each Stroke

W hen disabled, the Stamp tool keeps track of w hich draw ing it w as going to stamp next
w hen you finish draw ing a stroke by storing the number of that draw ing in the Stampsetting. W hen this option is enabled, it simply stops updating the Stamp setting. Hence,
your strokes alw ays start at the draw ing selected w ith that setting. Likew ise, you canmanually decide w hich draw ing to start your strokes w ith by adjusting the Stamp setting.

219

Chapter 2: Tools Properties

Stroke Tool Properties
W hen you select the Stroke tool, its properties and options appears in the Tool Properties view .

Icon

Tool Name

Description

Draw Stroke as
Straight Lines

Enable the Draw Stroke as Straight Lines option if you w ant the newstrokes you draw to be a perfect straight line. Disable the option if you
w ant the stroke to follow the mouse gesture.

Connect Line Ends

Enable the Connect Line Ends option if you w ant the start or end point of
your new stroke to connect to your existing strokes to make sure no gaps
are left in your draw ing.

W hen enabled, draw ing a closed shape w ill automatically fill it w ith thecurrently selected Paint colour.

Auto FillW hen enabled, draw ing a closed shape w ill automatically remove theoutstanding lines.

Trim Extra Lines

Align Handles AfterTrim

W hen the Trim Extra Lines option is enabled, enable this option to makethe point w here the beginning and end of the stroke meet into a smooth
curve rather than a hard corner.

220

Harmony 22 Paint Reference Guide

Auto-Flatten Mode

By default, w hen draw ing on a vector layer, each new stroke is created asa separate draw ing object, w hich can be edited independently from otherparts of the artw ork. W hen enabled, the Auto-Flatten option
automatically merges strokes into existing artw ork.

Allow s you to perform draw ing operations on both the Line Art and Colour
Art layers of your draw ing simultaneously.
Apply to Line andColour Art

NOTE
If you have Overlay and Underlay Art layers enabled, they w ill also
be affected w hen this option is enabled.

Apply to Synced
Draw ing Layers

If the currently selected layer is synced w ith another layer, the tool w ill
w ork on both the current layer and its synced layer.

Smoothness

You can modify the central line smoothness of your line using this option.
This parameter smooths the initial movement of your line. Increasing thevalue w ill result in a smoother line w ith few er control points. Use the left
and right arrow s to increment the value by one full unit. Use the Up Dow n slider to quickly increment the value.

221

Chapter 2: Tools Properties

Text Tool Properties
The Text tool lets you add text fields to your project, in w hich you can type text, then adjust its formatting
using various fonts and text attributes.
W ith the Text tool selected, you can select text w ithin text boxes you created and change the formatting of
the selection. You can also select and manipulate text boxes using the Select tool, and change the formattingof the entire text box in the Select tool properties.

How to access the Text tool propertiesl

In the Tools toolbar, select the Text

tool.

The tool's properties are displayed in the Tool Properties view .

Icon

Property

Description

Lets you select the font in w hich to display the text.

Font

Makes the selected text bold.
Bold

ItalicMakes the selected text italic.

222

Harmony 22 Paint Reference Guide

Icon

Property

Description

Aligns the text in the selected text box to the left.

Align Left

Aligns the text in the selected text box to the centre.

Align Center

Aligns the text in the selected text box to the right.

Align Right

Makes the text in the selected text box take all the horizontal space byadjusting the spacing betw een each w ord. Text that use a single line
and text in the last line of a paragraph is aligned to the left.

Justify223

Chapter 2: Tools Properties

Icon

Property

Description

Allow s you to set the size of the selected text.
Size

Allow s you to increase or decrease the spacing betw een eachcharacter.

Kerning

Auto Kern

Sets the kerning automatically based on the font’s predefined
standard.

Allow s you to increase or decrease the indentation of the first line oftext in each paragraph.
IndentIncreases or decreases the space betw een each line of text.

Line Spacing

224Harmony 22 Paint Reference Guide

Zoom Tool Properties
The Zoom tool lets you zoom in and out of the Camera, Draw ing, Side and Top view s. You can also use it toreset the zoom level.

How to access the Zoom tool properties
1. In the Tools toolbar, select the Zoom

tool.

The tool's properties are displayed in the Tool Properties view .

Tool Options
Icon

Parameter

Description

Zoom In ModeUse the mouse cursor to zoom in to the Camera or Draw ing view .

Zoom Out ModeUse the mouse cursor to zoom out of the Camera or Draw ing view .

Operations
Icon

Parameter

Description

Zoom in the Camera or Draw ing view .
Perform Zoom In
The keyboard shortcut is 2.

Perform Zoom
Out

Zoom out the Camera or Draw ing view .

Reset Zoom

Restores the current zoom level to 100%.

Reset View

Restores the original display by resetting any pan, rotation or zoom actions.

The keyboard shortcut is 1.

225

Chapter 3: Toolbars

Chapter 3: Toolbars
Harmony contains toolbars w hich, by default, are located at the top of the interface. Some view s also have a
toolbar w hich you can reposition to suit your w ork style. You can show or hide toolbars, as w ell as customize itw ith the tools you use most often and hide the ones you don't.
W orkspace Toolbars

227

Edit Toolbar

228

File Toolbar

229

Tool Presets Toolbar

230

Tools Toolbar

231

W orkspace Toolbar

236

View Toolbars

237

226

Harmony 22 Paint Reference Guide

W orkspace Toolbars
Harmony has a series of toolbars that are added by default at the top of the interface. These toolbars can be
moved on the sides of the interface as w ell as w ithin specific view s.
All top toolbars can be added by selecting W indows > Toolbars in the top menu.
Edit Toolbar

228

File Toolbar

229

Tool Presets Toolbar

230

Tools Toolbar

231

W orkspace Toolbar

236

227

Chapter 3: Toolbars

Edit Toolbar
The Edit toolbar contains common operations such as Undo, Redo, Cut, Copy and Paste. These commands canalso be found in the Edit top menu.

How to access the Edit toolbar
1. Select W indows > Toolbars > Edit.

Icon

Tool Name

Description

Undo

Removes the last change made to your project.
Harmony supports multiple undo, so you can undochanges you made in the order you made them.

Redo

Redoes an operation you have undone. This commandis active only after you use the Undo command.

Cut

Removes selected objects. You can then paste theobject or its properties to another object.

Copy

Copies selected objects and properties.

Paste

Places an object you cut or copied into the location
you select in a view .

Create Symbol

Creates a symbol from selected draw ing elements inthe Draw ing or Camera view or a layer or cells in theTimeline view .

228

Harmony 22 Paint Reference Guide

File Toolbar
The File toolbar contains buttons for common file operations such as New , Save and Open. These commands
can also be found in the File top menu.

NOTE
The

New , andServer,Save As buttons are only available in Harmony Stand Alone. W ith Harmony

Control Center must be used to create scenes.

How to access the File toolbar
1. Select W indows > Toolbars > File.

Icon

Tool Name

Description

Open

Displays the Open Scene dialog box w here you can brow se for ascene file. You can open a new scene from the current one and theprevious scene w ill close.

Save

Load Background File

Saves all changes made to the opened scene, draw ings, palettes, andpalette lists.

Allow s you to select an image to temporarily add as a background to
your draw ings, for reference. This background w ill not be in the scene.

229

Chapter 3: Toolbars

Tool Presets Toolbar
The Tool Presets toolbar lets you create new tool presets and manage them.

How to access the Tool Presets toolbar
1. Select W indows > Toolbars > Tool Presets.

Icon

Tool Name

Description

New Tool Preset

Creates a new tool preset from the current tool
settings.

Manage Presets

Opens the Manage Tool Preset dialog box w here you
can update, organize, and delete existing presets.

230

Harmony 22 Paint Reference Guide

Tools Toolbar
The Tools toolbar contains the main tools you need to w ork in Harmony. In the default w orkspace, this toolbar
located on the left edge of the application w indow .

TIP
Many toolbar buttons have a keyboard shortcut associated to them. You can check w hich keyboard
shortcut is associated to a button by leaving your mouse cursor over the button for a second. If the
button has a keyboard shortcut, it w ill be indicated in the tooltip that appears.

By default, the Tools toolbar hides some of its tools inside pop-up menus. For example, to select thetool, you must double-click or long-click the

Select tool button, and selectCutterCutter in the pop-up menu.

How ever, it is possible to make the Tools toolbar display each tool as a separate button by enabling the Flat
Tools Toolbar preference. This makes the selection of tools quicker.

How to make every tool in the Tools toolbar display in buttons rather than pop- up
menus
1. Do one of the follow ing to open the Preferences dialog:ll

W indows or GNU/Linux:l

In the top menu, select Edit > Preferences.

l

Press Ctrl + U.

macOS:l

In the top menu, select Harmony [Edition] > Preferences.

l

Press ⌘ + U.

2. Select the General tab.
3. In the Options section, check the Flat Tool Toolbar option.
4. Click OK.
5. Close and relaunch Harmony.

231

Chapter 3: Toolbars

NOTE
In Flat Tools Toolbar mode, some tools are hidden from the Tools toolbar by default. To
customize w hich tools are displayed in the Tools toolbar, and the order in w hich they aredisplayed, right-click on the Tools toolbar and select Customize.

How to customize which tools are displayed in the Tools toolbar when it is in Flat
mode
1. Right-click on the Tools toolbar and select Customize.
The Toolbar Manager dialog appears.

2. In the Available Tools list, select each tool that you w ant to add to the Tools toolbar, then click on
the Add the selected tool to the toolbar

button.

3. In the Toolbar list, select each tool that you w ant to remove from the Tools toolbar, then click on
the Remove the selected tool from the toolbar

Tool Name

Iconbutton.

Description

Allow s you to select and reposition, scale, rotate and skew brushstrokes, pencil lines, shapes and other parts of your artw ork.

SelectCutterAllow s you to cut a part of your artw ork, then reposition, scale,rotate and skew it.

Reposition All
Draw ings

Allow s you to reposition, scale, rotate and skew all draw ings in
the current layer.

232

Harmony 22 Paint Reference Guide

Contour Editor

Centerline Editor

Allow s you to edit the vector contours of brush strokes, pencil
lines and shapes in your artw ork. You can add, remove, tw eak andmove vector points, move the Bezier handles of the vector points
as w ell as deform vector outlines.

Allow s you to tw eak and deform a brush stroke by manipulating
the points at the centre of its line rather than its contour.

Allow s you to adjust the thickness of a pencil line at its different
Pencil Editor

points and corners, tw eak the shape of its extremities and scale its
texture.

Smooth Editor

Allow s you to optimize contours and lines by removing its extra
points, making them easier to edit.

Perspective

Allow s you to deform artw ork by applying a perspective effect onit.

Envelope

Allow s you to deform and w arp artw ork by moving points andtw eaking lines in a grid.

Edit Gradient/Texture

Allow s you to adjust the position, angle and size of gradients andtextures in a colour zone.

Brush

A pressure-sensitive tool for creating a contour shape w ith a thickand thin line effect, as if created w ith a paint brush.

PencilA pressure-sensitive tool for draw ing outlines. Pencil lines are
made of central vector lines, making them easier to tw eak and edit
than brush strokes.

Text

Allow s you to add text and to format it.

EraserA pressure-sensitive tool for erasing parts of a draw ing.

Paint

Allow s you to fill colour zones w ith a colour or texture.

Ink

Allow s you to recolour pencil lines w ith precision by changing thecolour of one segment at a time.

233

Chapter 3: Toolbars

Paint Unpainted

Allow s you to quickly fill empty zones in your artw ork w ith acolour or texture, leaving filled zones unchanged.

Repaint

Allow s you to quickly repaint painted zones in your artw ork.
Empty zones w ill remain empty.

Unpaint

Allow s you to empty filled colour zones of their colour andtexture.

StrokeAllow s you to create invisible lines that can serve as colour zones
that can be filled, or close the gaps in existing colour zones.

Close Gap

Allow s you to close open shapes so that they can be filled w ith
the Paint tool. By draw ing a stroke near a small gap in a shape,
this tool w ill create a small invisible stroke connecting the tw oclosest points around the gap.

Line

Draw s a straight line segment going from one point to the other.

Rectangle

Draw s a rectangle.

EllipseDraw s an ellipse.

Polyline

Allow s you to draw shapes, segmented lines or complex curvedlines by clicking to create each point in the sequence of line
segments.

Colour Eyedropper

Pencil Texture
Eyedropper

Allow s you to select a colour by clicking on a colour in yourartw ork.

Allow s you to select a pencil texture by clicking on a textured
pencil line.

Draw ing Pivot

Allow s you to position the pivot on a draw ing layer by clicking
w here you w ant its location to be.

Morphing

Allow s you to create and configure a morphing sequence, w hichw ill automatically generate the in-betw eens betw een tw o
draw ings in the current layer.

234

Harmony 22 Paint Reference Guide

Hand

Allow s you to pan the Camera and Draw ing view s.

Zoom

Allow s you zoom in and out of the Camera and Draw ing view s.

Rotate View

Lets you rotate the Camera and Draw ing view s just like w ith a realanimation disc.

Shift and Trace

Allow s you to temporarily move draw ings so you can trace overthem in other draw ings using Onion Skin.

W hen this option is selected, every time you use theTransform or
Animate Current Frame

Advanced Animation tools tomanipulate an element in your scene, the position of the element
w ill be stored in a keyframe at the current frame. This allow s you
to animate elements in your scene w ithout creating keyframes
manually.

W hen this option is selected, if you use theTransform or
Advanced Animation tools to make transformations
to an element in your scene, the transformations w ill be stored as
Animate Onion Skin
Range

keyframes at the beginning and at the end of the current Onion
Skin range, as w ell as on every existing keyframe in-betw een.
This can be useful if you w ant to reposition an element that you
have already animated, but only during a specific range of frames,
w hich you can define by enabling Onion Skin and setting theOnion Skin range to cover that range of frames.

W hen this option is selected, if you use theTransform or
Advanced Animation tools to make transformation
Animate Off

to an element in your scene, the transformations w ill affect theelement throughout the w hole scene. This can be useful if you
w ant to reposition an element after you have already animated it.

Transform

Allow s you to select draw ing layers and position, rotate, scale andskew them.

Onion Skin

Displays the previous and next frames of an animation. Usefulw hen animating cut-out characters.

Advanced Onion Skin

Enables Advanced Onion Skin, a more flexible kind of Onion Skinthat can be easily configured using the Onion Skin view .

235

Chapter 3: Toolbars

W orkspace Toolbar
The W orkspace toolbar lets you load other w orkspaces. The first time you start Harmony, the default
w orkspace is loaded. Other w orkspaces are available such as the Hand-Draw n Animation and Compositing
w orkspaces; these display different view s and toolbars. You can access these w orkspaces and any you create,from the W indow s menu and the W orkspace toolbar.

How to access the W orkspace toolbar
1. Select W indows > Toolbars > W orkspace.

Icon

Tool Name

Description

W orkspace List

Allow s you to select an existing w orkspace.

Opens the W orkspace Manager w here you can
W orkspace Manager

organize, display, and remove w orkspace from yourlist.

W hen the Automatically Save W orkspace preferenceis disabled, the Save W orkspace button becomes
available. This allow s you to manually save your new
w orkspace configuration.

Save W orkspace

236

Harmony 22 Paint Reference Guide

View Toolbars
Harmony has a series of view specific toolbars that are only available in a given view . These toolbars can be
moved only w ithin their view .
All view toolbars can be added, as long as the view is visible, through the top menu W indows > Toolbars >desired toolbar.

237

Chapter 4: View s

Chapter 4: Views
The Harmony interface is composed of different view s, each one designed for a specific purpose. You can
modify the location of the view s by adding a new view as a tab or as a w indow . You can also sw ap the locationof a view .
W hen a view is active, a red rectangle appears around the view . Keyboard shortcuts and top menu options areassociated w ith the active view . If a menu option is greyed out, it means it does not apply to the layer, draw ing
or other type of selection or the option does not apply to the active view .
Colour View

239

Draw ing View

246

Integrated Help View

249

Message Log View

250

Reference View

251

Tool Properties View

253

238

Harmony 22 Paint Reference Guide

Colour View
The Colour view is w here you create colours and palettes and import existing palettes into your project. The
Colour view is also necessary for draw ing, painting and creating colour styling.

How to access the Colour view
Do one of the follow ing:l

From the top menu, select W indows > Colour.

lFrom any of the other view s, click the Add View

button and select Colour.

Palette List Panel
Icon

OptionDescription

View Menu

The View menu contains all the commands and options that you canuse in the Colour view to manage colours and palettes.

239

Chapter 4: View s

Collapse/Expand Palette
List

Allow s you to show or hide your palette list and its options. By
default, the palette list is displayed, but you may w ant to hide it if you
are w orking w ith a single palette and w ant to allow more verticalspace for the colour sw atch list.

Add Palette

Allow s you to create a new palette.

Deletes the currently selected palette. If the colour sw atch is used inyour project, zones painted w ith colour sw atches w hich have been
deleted w ill turn red, easily identifying them so you can repaint themw ith another colour sw atch.

Remove Palette

Link Palette

Allow s you to add a palette from a different location, be it in a scene,
job, environment or even an element to your palette list. The palette
w ill be linked to its original location rather than copied to yourscene's folder. Hence, if you make changes to the original palette, it
w ill affect the colour of elements in your scene.
If you w ant to import a palette as a copy into your scene's palette
library, right-click on your palette list and select Import. You can also
link to a palette in any location on your machine or netw ork by
selecting Link to External.

Moves palettes further up or dow n the palette list.
Order Palette List

Edit Palette List Mode
Indicator

If a palette has been cloned, the highest palette among the original
palette and its clone(s) w ill be used by Harmony.

In Harmony Server, this icon appears w hen you have the modifying
rights on your scene's palette list. W hile several users can w ork on ascene at the same time, only one user may have the right to modify apalette list at any given time.

240Harmony 22 Paint Reference Guide

NOTE
In Harmony Stand Alone, you can alw ays modify your scene's
palette list. On Harmony Server, you must unlock your palette
list before making modifications to it.

Show Colour Palettes

Show s only colour palettes in the palette list. This is the default
option.

Show Pencil Texture
Palettes

Show s only pencil texture palettes in the palette list.

Show All Palettes

Show s both colour and pencil texture palettes in the palette list.

Palette List
Icon

Description

In Harmony Server, this indicates that you have the rights to modify the palette.

Indicates that the palette is stored at the same level as its palette list. For example, a palette that isstored in the scene's palette library and w hich is listed in the scene's palette list, or a palette that isstored in an element's palette library and w hich is listed in that same element's palette list.

Indicates that the palette file is stored in an external location, such as a different scene, an element in
a different scene, a job other than the scene's job, or an environment other than the scene's
environment. This means the palette is liable to be missing if it is moved from its original location, or if
the scene is exported from the database into an offline scene or to a different database.

This indicates that the palette is stored at a higher level than its palette list, making it a shared
palette. For example, a palette in your scene's palette list that is stored in the palette library of thescene's job or environment, or a palette in an element's palette list that is stored in the palette libraryof the scene.

Indicates a potentially dangerous situation. For example, a palette file that is stored in one of thescene's element folders, but w hich is added to your scene's palette list. The w hole scene can use thepalette, but since it's stored inside an element, deleting that element w ill make your w hole scene lose
access to that palette.

241

Chapter 4: View s

Navigation Panel
Icon

OptionDescription

Previous Draw ing

Navigates to the previous draw ing in the loaded draw ings list.

Next Draw ing

Navigates to the next draw ing in the loaded draw ings list.

Previous Column

Sw itches to the previous column in the loaded columns.

Next Column

Sw itches to the next column in the loaded columns.

Line Art

View and edit the draw ing's line art layer.

Colour Art

View and edit the draw ing's colour art layer.

Preview Line Art and Colour Art

If enabled, both the draw ing's line art and colour art layers w ill
be visible. If disabled, only the art layer you are currently
w orking on w ill be visible.

Colour Swatch List Panel
Icon

OptionDescription

Add Colour

Adds a new colour sw atch to the bottom of your colour list.

Remove Colour

The Remove Colour button lets you delete the currently selectedcolour sw atches. If the colour sw atch is used in your project, andconfirmation dialog w ill appear prompting you to confirm that you
w ant to delete the colour. Zones painted w ith colour sw atches
w hich have been deleted w ill turn red, easily identifying them so
you can repaint them w ith another colour sw atch.

242

Harmony 22 Paint Reference Guide

Allow s you to import a bitmap image as a texture, w hich can be
painted w ith just like a colour. W hen used w ith the Brush or Paint
tools, bitmap textures are tiled inside the shape they fill. The
scaling and position of the texture inside their shape can be
tw eaked w ith the Edit Gradient/Texture tool. W hen used w ith thePencil tool or one of the Shape tools, a bitmap texture w ill follow
the pencil line's direction.

Add Texture

Set Current Brush Colour

W hen enabled, the colour you select in the colour view w ill beselected for the Brush tool.

Set Current Pencil Colour

W hen enabled, the colour you select in the colour view w ill beselected for the Pencil tool, as w ell as other tools that create
pencil lines, such as the Line, Rectangle, Ellipse and Polyline tools.

Set Current Paint Colour

W hen enabled, the colour you select in the colour view w ill beselected for the Paint tool.

Link/Unlink Three Colours

W hen enabled, the colour you select w ill be selected for all

243Chapter 4: View sdraw ing tools. W hen disabled, you can select individual colours
for the Brush, Pencil and Paint tools.

In Harmony Server, this allow s you to get the modifying rights tothe selected palettes.

Edit Palette Mode

Since several people can w ork on any given scene at the sametime, and a palette can be shared betw een scenes, palettes may
be loaded in read-only mode w hen opening a scene on a Harmony
database. Then, an user w ould only be able to edit a palette by
first activating Edit Palette Mode. This prevents several users frommaking changes on the palette at the same time, since a user
cannot activate Edit Palette Mode on a palette that is alreadybeing edited by someone else. This also prevents users from
accidentally making modifications on important palettes.

In Harmony Server, this icon appears w hen you have the modifying
rights on the currently selected palette.
Edit Palette Mode Indicator

NOTE
In Harmony Stand Alone, you can alw ays modify yourpalettes.

Each colour sw atch available in the Colour view can have its ow n
name, making it easy to identify w hich colour is used to paint w hat
part of your character or background.

Colour Sw atch NameNOTE
Tw o colours can have the same name. Harmony identifies
colours by an identification number.

Colour Sw atch

Also referred to as colour pots, the colour sw atch is the actual244Harmony 22 Paint Reference Guide

colour information for a colour in your palette. It is represented bya rectangle displaying the colour in the list.

245

Chapter 4: View sDrawing View
Only the selected draw ing is displayed by default in the Draw ing view . You can use features, such as the lighttable to display the current draw ing of all the enabled layers of your scene in w ashed-out colours, or theOnion Skin to display the previous and next draw ings of the currently selected draw ing layer.

How to access the Drawing view
Do one of the follow ing:l

From the top menu, select W indows > Drawing .

lFrom any of the other view s, click the Add View

Icon

button and select Drawing.

SectionDescription

View Menu

The View menu contains all the tools and options thatyou can use in the Draw ing view to draw , animate andpaint.

246

Harmony 22 Paint Reference Guide

This is the main space in the Draw ing view . It is w here
you draw and w here the draw ings are displayed.

Draw ing Area

The Zoom menu lets you enlarge or reduce theCamera or Draw ing view display.
To make the camera frame size alw ays match the sizeof your view , select the Fit to View option. Click thedrop-dow n arrow and select a zoom level or press 1
and 2.

Zoom Menu

Draw ing NameThe Draw ing Name field displays the name of theselected draw ing, as w ell as the layer containing it. If
the cell does not contain any draw ing, an Empty
Cell text is show n in the field.

Tool Name

The Tool Name field displays the name of the selected
tool. If you temporarily override a draw ing tool using akeyboard shortcut, the tool’s name w ill be highlighted
in red. You can temporarily override a tool by holding
its keyboard shortcut w ithout the Alt key. For
example, the Select tool shortcut is Alt + S. If you holddow n the S key, you w ill sw itch to the Select tool.
W hen you release the key, you w ill return to the tool
you w ere using.

Frame NumberThis field displays the current frame of the animation
you are w orking on.

Cursor Coordinates

This indicates the position of the your pointer in thedraw ing area.

247

Chapter 4: View s

Colour Picker

The Colour Picker allow s you to select a colour fordraw ing.

Draw ing Thumbnails
Panel

The Draw ing Thumbnails panel displays a list w ith
thumbnails of the loaded draw ings. The highlighted
draw ing is the one displayed in the draw ing area. You
can select the draw ing you w ant to paint directly fromthis list.

248

Harmony 22 Paint Reference Guide

Integrated Help View
Use the Integrated Help w hen you are unsure about w hat a certain menu item is or the function of a specificpreference in the Preferences panel.
If you keep the Integrated Help w indow open for the entire duration of your w ork session, then you can use theforw ard and backw ard arrow s to scroll through a history of the help information that you called up during yoursession.

How to access the Integrated Help view
1. Do one of the follow ing:l

From the top menu, select W indows > Integrated Help.

l

From any of the other view s, click the Add View

249

button and select Integrated Help.

Chapter 4: View s

Message Log View
The Message log view displays information gathered during a render task, such as w hich frames and at w hattime they w ere each rendered. The view also contains a list of the colour recovery operations.

How to access the Message Log view
Do one of the follow ing:l

From the top menu, select W indows > Message Log.

l

From any of the other view s, click the Add View

250

button and select Message Log.

Harmony 22 Paint Reference Guide

Reference View
W hen you are draw ing, you can use a fully-painted draw ing or bitmap image as a reference and load it in the
Reference view . This draw ing or bitmap image can be used and loaded in any of your Harmony scenes.
Once imported, your references w ill be saved in the scene, and you w ill not need to re-import them. To load
your previously used references in the scene, right-click the Reference View Toolbar and select Load Default
References.

How to access the Reference view
Do one of the follow ing:l

From the top menu, select W indows > Reference View.

l

From any of the other view s, click the Add View

Tool/Menu Itembutton and select Reference View.

Icon

Description

View Menu

The View menu contains all the tools and options thatyou can use to manage references.

Reference View Toolbar

The Reference View toolbar contains all the tools andoptions you can use in the Reference view to navigate
through and manage references.

251

Chapter 4: View s

Allow s you to select a colour by clicking on a colour inyour artw ork.

Colour Eyedropper

252

Harmony 22 Paint Reference Guide

Tool Properties View
T-HFND-004-002
The Tool Properties view contains the most common options and operations related to the currently selected
tool. W hen you select a tool from the Tools toolbar, the Tool Properties view updates.
For example, if you choose the Select tool, the Tool Properties view w ill display the options and operations
related to it, such as Snap to Contour, Apply to All Draw ings, Flip Horizontal, and Flatten.

NOTE
To learn more about the options appearing in the Tool Properties view , see Tools Properties on
page 56.

How to access the Tool Properties view
Do one of the follow ing:l

From the top menu, select W indows > Tool Properties.

l

From any of the other view s, click the Add View

253

button and select Tool Properties.