Toon Boom Harmony 11.1
Scan Guide

1

Toon Boom Harmony 11.1 Scan 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 guide is covered by a specific limited warranty and exclusions and limit of liability
under the applicable License Agreement as supplemented by the special terms and conditions for
Adobe®Flash® File Format (SWF). For details, refer to the License Agreement and to those special
terms and conditions.
The content of this guide is the property of Toon Boom Animation Inc. and is copyrighted.
Any reproduction in whole or in part is strictly prohibited.
Trademarks
Toon Boom® is a registered trademark and Harmony™ is a trademark of Toon Boom Animation Inc.
Credits
Art Development: Shabana Ali, Marie-Eve Chartrand, Tania Gray, Annie Rodrigue, Anouk Whissell
Technical Editor: Peter Cawthorne, Pamela Grimaud, Liven Tam
Technical Reviewer: Joel Baril, Marc-André Bouvier-Pelletier, Lindsay Brown, Steve Masson, Elke
Starck, Lilly Vogelesang
Technical Writer: Shabana Ali, Marc-André Bouvier-Pelletier, Marie-Eve Chartrand, Christopher Diaz,
Annie Rodrigue, Liven Tam, Anouk Whissell
Publication Date
2014-11-28
Copyright © 2014 Toon Boom Animation Inc. All rights reserved.

2
2

Toon Boom Harmony 11.1 Scan Guide

Contents
1

Toon Boom Harmony 11.1 Scan Guide
Legal Notices

2

Contents

3

Chapter 1: Introduction

5

Topics Covered

5

Harmony Scan Module

6

Scanners and SCSI Adapters

7

Chapter 2: Interface

9

Topics Covered

9Interface Highlights

10

Top Menu

10

Control Panel

11

Scan Type Options

11

Drawing List

11

Frame Preview Panel

12

Image Panel

12

Chapter 3: Scanning with the Harmony Scan Module
Topics Covered13
13

Starting the Harmony Scan Module and Loading Drawings

14

Creating Scenes, Elements and Drawing Lists

16

Creating Elements from the Scan Module

17

Creating and Editing a Drawing List

19

Setting Up the Scanner

21

Displaying Scanner Information

22

Performing a Trial Scan

23

Scanning Drawings

25

Scanning with the Automatic Document Feeder

25

Scanning by Placing the Drawings Manually

27

Pegging and Scanning a Pan Cel

28

Stopping the Scanning Process30

Advanced Scanning Techniques

31

Scanning Drawings without Matching Frames

31

Loading Previously Scanned Drawings

33
3
3

Toon Boom Harmony 11.1 Scan Guide

Contents

Setting the Vectorization Style

33

Chapter 4: Menu Commands

35

Topics Covered

35

Menu Commands

36

Scan Menu Commands

36

File Menu Commands

36

Edit Menu Commands

36

Scanner Menu Commands

37

Help Menu Commands

37

Chapter 5: Configuring Scanners

39

Topics Covered

39

Configuring Scanners Using the Configuration Wizard

40

Configuring Scanners for Windows 7

42Running the findscanner Utility

42

Configuring the Scanner Using the Harmony Scan Configuration Editor

42

Configuring Scanners for Linux

46

Identifying the Name of the Scanner Device Driver46

Setting Permissions for the Scanner

47

Configuring Scanners for Mac OS X

48

Modifying the Scan.conf File48

Configuring Scan.conf to Communicate with the Scanner

50

Location of the Scan.conf File50

Location of Original Default Scan.conf File50

Adapting the Scanner Hardware

53

Modifying the ADF Paper Chute

53

Modifying the Scan.conf File for Centred ADF Scanning

53

Removing the Cog Wheel on Paper Chute

54

Adding a Paper Guide to Your ADF Scanner

54

Installing a Strip of Black Tape on the ADF Paper Path

55

Mounting the Peg Bar and Calibrating the Scanner

4
4

58

Toon Boom Harmony 11.1 Scan Guide

Chapter 1: Introduction

Toon Boom Harmony is a complete animation solution that offers a variety of tools to suit your needs,
from pre-production steps to the end of production. Some of these tools are provided in specialized
modules, such as the Xsheet, Paint, Scan and Play modules, which are designed to help you focus on a
specific task to ensure the efficiency of the entire production.
In this guide, you will learn how to use the Scan module and integrate it in your production workflow.

Topics Covered•

Harmony Scan Module on the next page•

Scanners and SCSI Adapters on page 755Chapter 1: Introduction

Harmony Scan Module

Harmony Scan Module

When working on a traditional animation production, in order to produce a scene, a large quantity ofdrawings must be scanned in. In order to speed up the process, these productions require the use of
automated scanners. The Harmony Scan module is used to communicate with these scanners and set
the parameters required to create the vectorization style and correct registration of the scanned
animation.

66

Toon Boom Harmony 11.1 Scan Guide

Scanners and SCSI Adapters
The Harmony Scan module works with high-end scanners using SCSI adapters and supports ourcustom drivers and TWAIN devices.

SCSI adapters are not standard hardware in PCs and Macs. If you plan to use a PC or Mac as a scanningstation, make sure to equip it with a supported SCSI adapter. We recommend that you dedicate a SCSI card
exclusively for scanners.

Here is the list of supported scanners which use our custom drivers:•

Epson 15000-GT Colour•

Epson 1640XL Colour•

Epson 836XL Colour•

Fujitsu M4097Ddim B&W•

Fujitsu M3096GX B&W•

Fujitsu fi-6770 Colour•

Fujitsu fi-5750C Colour•

Fujitsu fi-4750C Colour•

Fujitsu fi-4640S B&W•

Microtek 9600XL Colour•

Ricoh IS330DC Colour•

Ricoh IS760 Colour•

Ricoh IS420 B&W•

Ricoh IS430 B&W•

Ricoh IS450DE B&W•

Sharp JX-610 Colour•

Umax Mirage II Colour

77Toon Boom Harmony 11.1 Scan Guide

88

Toon Boom Harmony 11.1 Scan Guide

Chapter 2: Interface

It is important to become familiar with the following elements of the user interface as it will help you
get started using the Harmony Scan module. You can learn more about the highlights described here,
and how to use them in a production context throughout this guide.
When you start the Harmony Scan module for the first time, the default workspace is displayed. It
contains all of the main elements you need to use.

Topics Covered•

Interface Highlights on the next page99

Chapter 2: Interface

Interface Highlights

Interface Highlights
The Harmony Scan module has five major components.

Top Menu
The top menu contains most of the commands available in the Harmony Scan module.
The menu categories are:
Menu

Description

File

Lets you load drawings and manage exposure sheet elements.

Edit

Lets you modify the Drawing List, apply vectorization options and createa text file of scan details for each scanned drawing.

Scanner

Lets you eject a page from the scanner and display scanner information.

Help

Lets you access the integrated help system and Harmony Scan module version information.

10

Toon Boom Harmony 11.1 Scan Guide

In Mac OS X, there is a Scan menu with the following commands: About Scan and Quit—see Scan Menu
Commands on page 36.

Control Panel
The Control panel allows you to set up the scan.

Scan Type Options
When you select a scan type, you can control the following:•

Exposure•

Contrast•

Time required to scan a line, measured in lines per millisecond.

Drawing List
The Drawing list displays the names of the drawings loaded for scanning. As each drawing is scanned,
this is indicated.

11

Chapter 2: Interface

Frame Preview Panel

Frame Preview Panel
The Frame Preview panel shows the upcoming frame to be scanned.

Image Panel
The Image panel displays the current drawing being scanned.

12

Toon Boom Harmony 11.1 Scan Guide

Chapter 3: Scanning with the Harmony Scan ModuleToon Boom Harmony's dedicated Scan module lets you scan drawings fast. It creates a drawing list
from the previously created exposure sheet. To use this module, you must create your exposure sheet
in Toon Boom Stage before the scan process.

Topics Covered•

See "Starting the Harmony Scan Module and Loading Drawings " on page 14•

Creating Scenes, Elements and Drawing Lists on page 16•

Creating Elements from the Scan Module on page 17•

Creating and Editing a Drawing List on page 19•

Setting Up the Scanner on page 21•

Displaying Scanner Information on page 22•

Performing a Trial Scan on page 23•

Scanning Drawings on page 25•

Scanning with the Automatic Document Feeder on page 25•

Scanning by Placing the Drawings Manually on page 27•

Pegging and Scanning a Pan Cel on page 28•

Stopping the Scanning Process on page 30•

Advanced Scanning Techniques on page 31•

Loading Previously Scanned Drawings on page 33•

Setting the Vectorization Style on page 33

13

Chapter 3: Scanning with the Harmony Scan Module

Starting the Harmony Scan Module and Loading Drawings

Starting the Harmony Scan Module and Loading Drawings
Usually, when you are ready for scanning, a scene has been created containing the elements to bescanned and the exposure sheet has been filled.

If you have not previously prepared your scene’s exposure sheet or created your elements or scenes, you
can always create drawing lists, elements or scenes directly from the Harmony Scanmodule without having
to go through the Control Centre.

How to start the Scan module and load your scene
1. Double-click on the Harmony Scan module

icon or do one of the following:‣

Mac OS X: Select Applications > Toon Boom Harmony 11 > Scan.

‣

Windows: Select Start > All Programs > Toon Boom Harmony 11 > Scan.

‣

Linux: Select /usr/local/ToonBoonAnimation/harmony_11/lnx86_64/bin > Scan.

If there is no scanner properly installed or connected to the computer you are using, the following
message displays:‣

Click Continue to open the Harmony Scan module. Note that you will not be able to scan.

‣

Click Exit Scan Program to quit the Scan module.

If you think this message is incorrect and your computer is connected to a scanner, contact yoursystem administrator.
The database login dialog box opens.

2. Enter your Harmony username in the User Name field and click Login.

14

Toon Boom Harmony 11.1 Scan Guide

The Database Selector dialog box opens, displaying the Environments available from the Harmony
database.

3. Select the Environment, Job, Scene and then the Element you want to scan.

4. Click Open.
The Drawings Selector dialog box opens, listing all the drawings contained in the selected element.

The Drawing column displays the names of the drawings. The Scanned column indicates if thedrawing has been scanned.
5. If needed, add new drawings to the list by typing a drawing name in the Add Drawing field and click
Add Drawing.

The new drawing appears in the list.
6. Select the drawings you want to scan.
‣

Select the specific drawings from the list. You can select several drawing using Shift + click.

15

Chapter 3: Scanning with the Harmony Scan Module

Starting the Harmony Scan Module and Loading Drawings‣

Click All to select all the drawings in the list.

‣

Click None to unselect all drawings.

‣

Click Scanned to select only the drawings that are indicated as scanned (Yes) in the list.

‣

Click Unscanned to select only the drawings that are indicated as not scanned (No) in the list.

7. Click OK.
The selected drawings appear in the Drawing List column.

Once your session is started, you can open the Database Selector window at any time to load otherdrawings.
How to load drawings when the Scan module is already started
1. Select File > Open Drawings.
2. Follow steps 4 to 7 in the previous procedure: "How to start the Scan module and load your scene".

Creating Scenes, Elements and Drawing Lists
Before you can scan drawings, you must have a scene, element and drawing list ready. You can create
these directly from the Harmony Scan module without having to go through the Control Centre.
How to create a scene from the Harmony Scan module
1. Start the Harmony Scan module and log to in the database using your Harmony user name.
The Database Selector dialog box opens, displaying the Environments available from the Harmony
database.

2. Select the Environment and Job in which you want to add a scene.

16

Toon Boom Harmony 11.1 Scan Guide

3. Click Create Scene.
The Create Scene dialog box opens.

4. In the Scene Name(s) field, type the new scene’s name. Press Enter/Return after each scene’s nameto create additional scenes.

5. Select the file system from the File System list. Click Other File System to select another file system
to use.

To learn more about creating a project in the database, refer to the Toon Boom Control Centre Guide.

6. Select where you want to place your new scenes in the database scene list using the Add Scenes
menu.

‣

At Bottom: Places new scenes at the bottom of the scenes list.

‣

At Top: Places new scenes at the top of the scenes list.

‣

Name Sort: Sorts new scenes alphabetically.

7. Click OK.
The new scenes appear in the Database Selector.

Creating Elements from the Scan Module
How to create elements from the Scan module
1. Start the Harmony Scan module and log in to the database using your Harmony Scan user name.
The Database Selector dialog box opens, displaying the Environments available from the Harmony
Stage database.

17

Chapter 3: Scanning with the Harmony Scan Module

Starting the Harmony Scan Module and Loading Drawings

2. Select the Environment, Job and Scene in which you want to add elements.

3. Click Create Element.

If your system administrator did not complete the resolution configuration tasks, awarning message displays. This message notifies you that the resolution.conf file
was not properly inserted in the configuration folder.

4. Click OK to continue.
The Harmony Scan module opens and the Create Element dialog box opens.

5. In the Name field, type the new element’s name.

6. Select Vector option if the element is to be vectorized.

7. Select the bitmap format of your element; this list is only available if you did not select the Vector
option.

18

Toon Boom Harmony 11.1 Scan Guide

8. Select a scan type.

‣

Colour: Creates a colour bitmap element.

‣

Greyscale: Creates a greyscale bitmap element.

‣

B&W: Creates a vector-based element that is going to be painted using the Harmony
Stage or Harmony Paint module.

9. Select the field chart size of your element.

10. When you are done:‣

Click OK to add the element and return to the Database Selector.

‣

Click Add to add the element and keep the dialog box open to add more.

‣

Click Close to cancel and return to the Database Selector without adding an element.

Creating and Editing a Drawing List
There are two ways you can create and edit a drawing list from the Scan module.
•

Creating or Editing a Drawing List When Loading your Element.

•

Creating or Editing a Drawing List When your Element is Already Loaded.

How to create or edit a drawing list when your element is already loaded
1. In the Harmony Scan module, select Edit > Drawing List.
The Drawing Selector dialog box opens listing all the drawings contained in the loaded element.

19Chapter 3: Scanning with the Harmony Scan Module

Starting the Harmony Scan Module and Loading Drawings‣

The Drawing column lists the name of the drawings.

‣

The Scanned? column indicates if the drawing has been scanned.

2. In the Add Drawing field, type a drawing name.

3. Click Add Drawing.
The new drawing appears in the list.
4. Select the drawings you want to scan.
‣

Select specific drawings from the list. You can select several drawings using Shift + click.

‣

Click All to select all the drawings in the list.

‣

Click None to unselect all drawings.

‣

Click Scanned to select only the drawings that are stated as scanned (Yes) in the list.

‣

Click Unscanned to select only the drawings that are stated as not scanned (No) in the list.

5. Click OK.
The selected drawings appear in the Harmony Scan module Drawing List.

20

Toon Boom Harmony 11.1 Scan Guide

Setting Up the ScannerOnce you have started the Harmony Scan module and loaded your drawing list, you can set up yourscan session with the different scanner options in the Control panel.
How to set up the scan session
1. Start the Harmony Scan module and load your drawing list.
2. In the Control panel, select a scanner from the Scanner menu.

The default model appears first in the scanner configuration file, scan.conf.
You can find the scan.conf file here:‣

Linux: /usr/local/ToonBoomAnimation/harmony_11/lnx86_64/bin/ConfigEditor‣

Mac OS X: Applications > Toon Boom Harmony11 > Tools > Configuration Editor‣

Windows: All Programs > Toon Boom Harmony11.0 > Tools > Configuration Editor

3. From the Scan Type menu, select a scan type. If there is more than one scanner connected to yourcomputer, only the scanners that support the selected scan type are displayed.
•Black & White: Scans a line art drawing that you will paint in the Paint or Stage module.

•

Greyscale: Captures the shades of grey in drawings.

•

Colour: Scans a pre-coloured drawing, such as a background or overlay.
When you select a scan type, additional context-sensitive options appear on the lower part of theControl panel.

4. From the Peg Position menu, set the location of the pegs or registration holes on the paper you arescanning. The images will be automatically rotated based on your selection.
•

Bottom Peg: The peg holes appear below the drawing.

•

Top Peg: The peg holes appear above the drawing.

•

Left Peg: The peg holes appear on the left of the drawing.

•

Right Peg: The peg holes appear on the right of the drawing.

5. From the Resolution menu, select a resolution. This determines the quality and size of scanned
images. The resolutions that appear in the list depend on the selected scanner.
6. From the Field Size menu, select the size of the paper you are scanning. The different choices appear
in field units. Note that the autofeed mode does not support paper larger than 12 field.
7. Select the Pencil Test option if you want to perform a line test. A black and white image will becreated with no paintable colour art regions. If you select this option, the Scan: Pencil Test
Confirmation dialog box opens.

21

Chapter 3: Scanning with the Harmony Scan Module•

Press Yes to confirm.

•

Press No to cancel.

Setting Up the Scanner

8. Select the Optical Registration option to automate the alignment of the drawings using theregistration holes on the drawing paper.
9. Select the Flip Drawing option to flip the scanned image horizontally and realign the registration
holes.
Once you set up the main scanner options from the Control panel, you are ready for a test scan tocalibrate the scanned images.

Displaying Scanner Information
You can display the scanner information, such as the scanner name, device, model and description with
the Info command.
To display scanner information:
1. From the top menu, select Scanner > Info.
The Scanner Information dialog box opens.

22Toon Boom Harmony 11.1 Scan Guide

Performing a Trial Scan
The Harmony Scan module allows you to perform test scans to determine the proper threshold or
gamma setting for a drawing. A test scan lets you preview the scanned image without saving it. You
can perform a trial scan by auto feeding the drawing through the scanner or by pegging the drawing
on the scanner.
How to perform a trial scan
1. Start the Harmony Scan module and load your drawing list.
2. Place the drawing on the scanner pegs or in the automatic document feeder (ADF).
3. On the Control panel, select the appropriate feeding type from the Feed menu.

‣

Autofeed: Feeds the drawings through the ADF.

‣

Autofeed (One): Accepts one drawing from the ADF when the Scan button is pressed.

‣

Pegged: Scans a drawing from the flatbed each time the Scan button is pressed.

‣

Pegged (Many): Automatically scan a drawing from the flatbed every five to ten seconds(depending on the time required to process the drawings).

‣

Pan Cel: Scans a drawing that is bigger than the scanner window in separate sections.

4. Click Preview. If you are manually pegging the drawing, make sure to close the scanner cover before
you click the Preview button. When the scan is complete, the drawing appears in the Frame Preview
panel of the Harmony.
5. Adjust the image parameters. Different options appear on the Control panel depending on the scan
type you selected—see Setting Up the Scanner on page 21.

Scan Type

ParameterAll

Speed: Adjusts the time required to scan a line (measured in lines per millisecond) at which to scan drawings, if your scanner supports variable
speeds. Use the drop-down menu to set predefined speeds of Fast,
Normal, or Custom.

23

Chapter 3: Scanning with the Harmony Scan Module

Black & White

Performing a Trial Scan

Threshold: Adjusts the exposure.
Black Point: Use this slider with the White Point slider to adjust
the contrast. Greyscale values that are less than the selectedvalue are converted to black.

GreyscaleWhite Point: Use this slider with the Black Point slider to adjust
the contrast. Greyscale values that are greater than theselected value are converted to white.
ColourGamma: Adjusts the colour contrast.

6. Click Preview to view the changes.
7. Keep adjusting these values until you get the effect you want. These values will be applied to all thesubsequent drawings you scan.

To keep the image from a trial scan without having to rescan the drawing, click Save to assign the image tothe currently selected drawing name in the Drawing list and mark it as scanned.

24Toon Boom Harmony 11.1 Scan Guide

Scanning Drawings
After building your exposure sheet, opening the cells in the Harmony, configuring the scanner, finetuning the scan settings and previewing the scanned drawings, you are now ready to begin the final
scanning process.
There are five ways to feed drawings through the scanner:•

Autofeed: Scans all drawings in the automatic document feeder (ADF).

•

Autofeed (One): Scans the drawings in the ADF one at a time, and click Scan for each drawing.

•

Pegged: Scans a drawing on the scanner. Click Scan each time you change the drawing on thescanner.

•

Pegged (Many): Automatically scans the drawing in the scanner every five to ten seconds(depending on the time required to process the drawings).
However, this mode does not scan each drawing automatically when you click the Preview button.

•

Pan Cel: Scans a drawing into the system in separate sections because the drawing is bigger than
the scan window.

You may find that the Autofeed option is not available on your system, since your scanner may notsupport it. The field size you select can also determine which mode is available.
•

All scanning modes support 12 field.

•

The Autofeed modes do not support 16 field or higher.

Drawings are scanned in the order in which they appear in the Drawing list.

•

If you want to reverse the order of the drawings, select Edit > Reverse List Order.

•

If you want to make any other sorting changes, reselect the drawings from theDrawing Selector dialog box.

•

You may need to re-enter your list of drawings using the File > Build Manual List
command.

Scanning with the Automatic Document Feeder
If the selected scanner supports an automatic document feeder (ADF), you can set your scanner toautomatically feed the drawings for scanning. There are two options for doing this: automaticallyscanning the drawings or scanning drawings one at a time.
You can use the ADF to scan a stack of drawings continuously on a black and white scanner. Manyscanner models support up to A3-sized paper in the ADF (15 field). If you are scanning a 16-fielddrawing, you may have to manually peg it on the scanner.
Since you must splice multiple drawings in a pan cel together once you have scanned them all, you
cannot feed pan drawings through the ADF. When you use the black and white scanner’s ADF to scana stack of drawings, the scanner optically detects the peg holes on the drawing and registers theimage accordingly.
How to scan your drawing using the automatic document feeder (ADF)
1. Start the Harmony and load your drawing list.

25

Chapter 3: Scanning with the Harmony Scan Module

Scanning Drawings

2. In the Control panel, select a feed type from the Feed menu:‣

Autofeed: Scans all the drawings in the automatic document feed (ADF).

‣

Autofeed (One): Accepts one drawing from the ADF when the Scan button is pressed.

3. Sort the paper drawings in your scanner in the same order as they appear in the Drawing List.

The Scan module uses the Drawing list order to scan the drawings.
4. If need be, reorder the Drawing list:‣

To reselect the drawings you want to scan, select Edit > Drawing List.

‣

To reverse the Drawing list order, select Reverse List Order

5. Before placing the drawings in the ADF paper chute, position the paper guide closest to the back of
the scanner as far out as it can go (towards the back of the scanner).
6. Place the drawings in the ADF paper chute (either face up or face down, depending on the type ofscanner you have).
‣

The first drawing to scan must be at the bottom of the stack once you put it on the scanner,with the registration holes towards the back of the scanner (where the pegs are).

‣

When you place the drawings in the ADF paper chute, insert them so that they are slightly
touching the paper guide closest to the back of the scanner, and the edge of the drawings
lightly touch the inside of the ADF.

Do not insert the drawings too tightly on the inside of the ADF or multiple drawings may feed through at thesame time, causing registration errors.

7. Slide the other paper guide over (closest to the front of the scanner) so that it slightly touches thedrawings. You are now ready to scan the drawings.
8. Select a scanning mode from the Feed menu:‣

Autofeed: Scans all the drawings in the automatic document feed (ADF).

‣

Autofeed (One): Accepts one drawing from the ADF when the Scan button is pressed.

9. Click Scan.
The scanner begins to capture the drawings. You can interrupt the scan by clicking the Stop
button—see Stopping the Scanning Process on page 30.
As the scanner captures the drawings:

26

Toon Boom Harmony 11.1 Scan Guide‣

The drawing appears in the Image panel.

‣

You should check the drawings as the scanner captures them to ensure that the line quality is
consistent from drawing to drawing. If necessary, adjust the threshold for a drawing.

‣

You can modify the scale to better view the drawings.

‣

If you selected the Autofeed option, the animator’s label for the drawing you just scanned
appears in the Last Scanned panel, which appears only when using the Autofeed or Autofeed(One) modes. A portion of the entire scanned image appears in this window. Scroll to theanimator’s label using the scroll bars.

‣

The entire drawing appears in Frame Preview panel.

‣

When the scan is complete, the Drawing List tags the drawing as Scanned and highlights thenext drawing.

‣

If an optical registration error occurs, a dialog box appears.
- Make sure to place the drawing correctly in the ADF and there are no tears or rips on thedrawing’s registration holes. Try feeding and scanning the drawing again by clicking Retry.
- The size of the paper you used may not be close enough to a standard 12-field paper size. The
Harmony module looks for the centre peg hole at a specific distance from the leading edge of thepaper (give or take an inch).
- To correct this error, you must scan these drawings on a flatbed scanner instead of using an
ADF scanner.
- To continue scanning and fix the drawing later, click Skip Drawing. The scanner marks thedrawing as "Not Scanned" and the autofeed takes the next drawing.

When the scanner captures the last drawing in the Drawing List, the Scan and Preview buttons
become active again.
10. If you want to rescan a drawing, simply select the cell name from the Drawing List and click Scan.
‣

Remember to change the feed mode you selected before clicking the Scan button. If you arescanning one drawing, select Autofeed (One) from the Feed menu.

‣

If you are rescanning more than one drawing, select Edit > Drawing List, type the names ofthe drawings you want to rescan, and click OK.

If a paper jam occurs in the ADF (with the compatible scanners), use the Eject Page command to eject the
jammed page. Select Scanner > Eject Page. If the option is not compatible with your scanner, the command
will be greyed out.

Scanning by Placing the Drawings Manually
You can scan a drawing by placing it on the scanner registration pegs yourself. If the drawings you
want to scan are too large to fit in the scanner’s automatic document feeder or do not feed properly
due to rips, wrinkles, or folds in the drawing, you can manually peg the drawings.
However, this mode does not scan each drawing automatically when you click the Preview button.
How to scan by manually pegging drawings
1. Select one of the following options from the Feed menu:‣

Pegged: Scans the drawing from the flatbed. Click Scan for each drawing.

‣

Pegged (Many): Scans the drawing from the flatbed every five to ten seconds (depending on
the time required to process the drawings).

27

Chapter 3: Scanning with the Harmony Scan Module

Scanning Drawings

2. Check the Drawing List to see which drawing you are scanning next. It will appear highlighted.
‣

You can select the drawing you want to scan by pointing to the desired drawing in the
Drawing list, and clicking Scan.

‣

You can reverse the order of the Drawing list by selecting Edit > Reverse List Order.

The Drawing list sorts the cell names from your exposure sheet alphanumerically. You should keep
this in mind when assigning names to these cells, otherwise, you may need to resort your drawings
so the Harmony can assign them in the correct order.
3. Lift the scanner cover and place the drawing face down on the scanner glass with the peg holes ofthe drawing positioned on the registration pegs bar on the scanner. This should be the paper
drawing that corresponds to the drawing highlighted in the Drawing List.
You can place both 12 field and 16 field paper on the same registration pegs on the scanner. The
Field menu in the scanner’s setup options defines the paper size being scanned.
4. Close the scanner cover, making sure the paper lays flat against the glass, free of wrinkles and folds.
You are now ready to scan the drawing.

Never scan a drawing while the scanner cover is open. If you do, large black areas can appear aroundthe edges (similar to a photocopier with the lid open). The scanner interprets this extra black area aspart of the drawing, which drastically slows the vectorization process. If by mistake you do scan adrawing with the cover open, you can go to the vectorize queue and delete the entry before it starts
processing. Refer to the Toon Boom Server Guide to learn more about this.

5. Click Scan.
‣

If you set the scan mode to Pegged, the scanner scans the drawing, then stops and waits foryou to change the drawing and click the Scan button again.

‣

If you set the scan mode to Pegged (Many), the scanner continues to capture a drawing every
five to ten seconds (depending on how long it takes to process each drawing).

While the scanner captures the drawing, the Scan button becomes inactive.
You can interrupt the scan by clicking Stop—see Stopping the Scanning Process on page 30.
When the scan is complete, the captured image appears in the Harmony. In the Drawing list, thedrawing is indicated as 'scanned' and the next drawing to scan appears highlighted.
6. If you set the scan mode to Pegged (Many), wait for the scanner to stop after each drawing andplace the next one before it starts again.

Pegging and Scanning a Pan Cel
Pan cels are drawings that contain more than one set of registration holes. Because pan cels are large,
you cannot scan the entire image with one pass on the scanner.
Therefore, you must scan pan cels one section at a time (one set of registration holes at a time). Afteryou scan each section of the pan cel, the sections are spliced together to create the original pan cel
image.
There must be exactly eight inches (2.54 centimetres) between the centre peg holes (the round holes)
for each pan cel and the peg holes must all align exactly. This is important if the Harmony must makeslight seaming adjustments to compensate for angle differences when it joins all the pan cels to form
one drawing.

28

Toon Boom Harmony 11.1 Scan Guide

How to scan a pan cel
1. Start the Harmony and load your drawing.
2. In the Control panel, select Pan Cel from the Feed menu.
The Peg Hole panel appears below the Image panel.

‣

By default, two pegs appear in the Peg Hole panel. If your pan cel has more than two peg
holes, use the New button to add more.

‣

If you added too many peg holes, simply select a different format from the Feed menu andreselect Pan Cel again. The two peg holes reappear by default.

3. Determine where peg hole A appears on your pan cel.

The Harmony Scan module considers peg hole A to be the leftmost peg position on horizontal pancels, and the topmost peg position for vertical pan cels.

4. Place the pan cel face down on the scanner glass with the round A peg hole placed on the roundregistration peg on the scanner or position it in the optical registration search area as definedearlier. Close the scanner cover.
5. Select the peg hole you are scanning first from the Peg Hole panel.

‣This procedure assumes you are scanning peg hole A first, then continuing scanning the restof the peg holes in sequence.

‣

You can actually scan the peg holes in any order, as long as you select the lettered button in
the Peg Hole panel that corresponds to the peg position you are scanning.

6. Click on the Scan (A) button. To interrupt scanning at any time, click Stop—see Stopping the
Scanning Process on the next page.
The scanner scans the first section of the pan cel and displays a preview of the scanned image above
the A button in the Peg Hole panel.
7. On the scanner, move the pan cel so that peg hole B is on the round registration peg on the scanneror position it in the optical registration search area as defined earlier and close the scanner cover.
8. Select the B option from the Peg Hole panel and click the Scan (B) button.

29

Chapter 3: Scanning with the Harmony Scan Module

Scanning Drawings

The scanner inputs the second section of the pan cel and displays a preview of the scanned image
above the B button in the Peg Hole panel.
9. Repeat these steps until you have scanned all the panels of your pan cel.
10. When you have scanned all the drawings for the pan cel to form a single drawing, click Save.

Stopping the Scanning Process
You can use interrupt scanning at any time. When you do, the scanner may not stop immediately sincethe Harmony module must finish its current process.
How to stop the scanning process
1. Click Stop.
The Stop Scanning dialog box opens.
2. Select one of the following:‣

Stop Immediately: Stops the scanner from finishing the current drawing scan. The Harmonymarks the drawing as "Not Scanned".

‣

Finish This Drawing button: Continues the scanning, saves the current drawing, and thenstops the scan process.

30

Toon Boom Harmony 11.1 Scan Guide

Advanced Scanning Techniques
In most cases, you only need to scan your drawings into empty cells in your exposure sheet. Harmony
is flexible enough to allow you to add drawings in other ways. These other methods include:•

Scanning paper drawings without matching cells in the exposure sheet•

Loading previously scanned images into matching cells in the exposure sheet

Scanning Drawings without Matching Frames
If you want to preview one or more drawings that don’t have a corresponding list of cells in theControl Center’s database yet, you don’t have to go through the whole procedure of creating anenvironment, defining the jobs, scenes, and elements, and then creating an exposure sheet. These
would be a list of cells that were not entered in the exposure sheet and do not appear in the Database
Element Selector dialog box.
To scan these new drawings, you must specify the path and file names for the drawings to be saved.

The Harmony Scan module does not vectorize these types of digital drawings and you cannot view them in
the Control Centre. If you do decide to use these drawings, you must follow the standard procedure forscanning drawings for a regular scene (with the Control Center and Harmony Stage modules).

How to manually build a list of drawings to scan
1. Select File > Build Manual List.
The Manual List dialog box opens.

2. In the Path field, type in an existing directory path where you want to store the scanned drawings.

3. Type in a name in the Prefix field that appears at the beginning of the scanned files that correspondto the drawing names you subsequently add to the manual list.

31

Chapter 3: Scanning with the Harmony Scan Module

Advanced Scanning Techniques

For example, if you enter the name of the character joe in the Prefix field, then add the drawing
names 01 and 02, the Drawing List would display 01 and 02, but once you scan the drawings, the files
would appear as follows:‣

joe-01‣

joe-02The prefix and a dash automatically appear in front of the drawing names you add when the Harmony
creates the files of the scanned drawings.

4. Type the name of the drawing you want to scan in the Drawings field and click Add.

The name of your drawing appears in the Drawings panel. Repeat for every drawing you add.

‣

For a quick way to create a series of drawings, type the first and last number with a colon (:)
between them.

For example, if you want to create a series of drawings numbered from one to six, type thefollowing in the Drawings field and click Add:•

1:6

5. Select the drawings you want to add to the Drawing List. By default, all the entries appear selected,
but you can select the drawing(s) you want to scan.

6. Click OK.
The selected drawings appear in the Drawing List of the Harmony Control panel.

32

Toon Boom Harmony 11.1 Scan Guide

To modify the manual entries in the Drawing List, you must reopen the Manual List dialog box and go
through the process of building the manual entries again.

Loading Previously Scanned Drawings
The Load From File command allows you to load a previously scanned drawing into the Harmony. Thisis useful if you want to view a drawing you already scanned.
How to load a previously scanned drawing
1. Select File > Load From File.
The Select File To View dialog box displays the directories and files in the current directory. You canload graphics in any of the following bitmap formats:‣

OMF: Open Media Framework image format. This format is compatible with Avid
applications.

‣

OPT: An optimized version of the SCAN image format. This format retains the alpha channel
information for the image. It also preserves the quality of the image while keeping the file size
low.

‣

RCI: The drawings are in Recognition Concepts Inc. image format.

‣

Scan: The scan image format, which retains the image's scanning information (resolution in
dpi, drawing registration) that the Stage Module uses.

‣

SGI: The drawings are in the Silicon Graphics Inc. image format, which retains the image's
alpha channel information.

‣

TGA: The drawings are in the Generic Targa image format, which the image's alpha channel
information and is widely compatible (cross-platform).

‣

VAR: The drawings are in the Variable header image format.

‣

YUV: The drawings are in a graphic type for animations that appear in National Television
System Committee (NTSC) image format.

‣

PAL: The drawings are in a graphic type for animations that appear in Phase Alternating Line
(PAL) image format.

2. Browse to the folder where your scanned drawings are saved.
3. Select a file to view and click OK.

Setting the Vectorization Style
You can set the vectorization style you want to apply to any subsequent drawings that will be sent to
the Vectorize Queue in the Control Centre.
How to set the vectorization style
1. Select Edit >Vectorize Style.

33

Chapter 3: Scanning with the Harmony Scan Module

Advanced Scanning Techniques

The Vectorization Styles dialog box opens.

2. Select the desired vectorization style from the list and click OK.
To learn how to edit and set up the vectorization styles, refer to the Harmony Stage User Guide.
To learn more about the Vectorize Queue and the Control Centre, refer to the Toon Boom Harmony
Control Centre Guide

34

Toon Boom Harmony 11.1 Scan Guide

Chapter 4: Menu Commands

The menu commands in the Harmony let you access commands for executing many different tasks.

Topics Covered•

Menu Commands on the next page

35

Chapter 4: Menu Commands Menu Commands

Menu Commands
The top menu the Harmony lets you access many commands for performing tasks.

Scan Menu Commands
If you are using Mac OS X, the Scan menu commands let you display product and version information,and close the Harmony.
How to access the Scan commands
1. From the top menu, select Scan > command.
Command

Description

About Scan

Displays product and version information.

Exit

In Mac OS X, closes the Harmony and ends the current session.

File Menu Commands
The File menu commands let you open drawings, select scanned drawings to load, create a list oflabelled cells and close your session.
How to access the File menu commands
1. From the top menu, select File > command.
Command

Description

Open Drawings

Opens the Database Selector dialog box in which you select the drawings
to be scanned or add new scenes and elements to a job.

Load From FileLets you select a previously scanned drawing to load into the Harmony
Scan module.

Build Manual List

Opens the Manual List dialog box for you to create a list of labelled cells.

Exit

In Windows or Linux, closes the Harmony Scan module and ends your current session.

Edit Menu Commands
The Edit menu commands let you open the drawing list, reverse the drawing list, select thevectorization style, and create a plain text file for each scan.
How to access the Edit menu commands
1. From the top menu, select Edit > command.
Command

Description

Drawing List

Opens the Drawings Selector dialog box for labelling cells to accept drawings.

Reverse Drawing List

Reverses the sequence of drawings in the Drawing List.

Vectorize Style

Opens the Vectorization Styles dialog box for selecting thevectorization style to apply when scanning drawings.

36

Toon Boom Harmony 11.1 Scan Guide

Create ScanInfo File

Creates a plain text file for each subsequent scan. This file contains information such as the paper size and DPI used during scanning. Each plain text
file is located in the same directory and has the same file name as thescanned image with the file extension SI.

Scanner Menu Commands
The Scanner menu commands let you eject paper from a scanner and access scanner information.
How to access the Scanner menu commands
1. From the top menu, select Scanner > command.
Command

Description

Info

Opens the Scanner Information dialog box to view scanner name, device,model, and description information.
Ejects a page from a scanner’s automatic document feeder(ADF). This command is only activated when a paper jam
occurs. This option is not available on all the scanners.

Eject Page

Help Menu Commands
The Help menu commands let you access scanner information, identify problems when scanning andaccess the documentation.
How to access the Help menu commands
1. From the top menu, select Help > command.
Command

Description

About

In Windows or Linux, displays product and version information.

Debug Mode

Identifies a problem encountered in Harmony.

Help

Opens the online help product documentation.

37

Toon Boom Harmony 11.1 Scan Guide

38

Toon Boom Harmony 11.1 Scan Guide

Chapter 5: Configuring Scanners
Before you can start scanning drawings, you will need to connect, configure, and calibrate yourscanner to work with Harmony. It is important that you install the scanner hardware according to the
manufacturer's instructions.

Topics Covered•

Configuring Scanners for Windows 7 on page 42•

Configuring Scanners for Linux on page 46•

Configuring Scanners for Mac OS X on page 48•

Configuring Scan.conf to Communicate with the Scanner on page 50•

Adapting the Scanner Hardware on page 53

39

Chapter 5: Configuring Scanners Configuring Scanners Using the Configuration Wizard

Configuring Scanners Using the Configuration Wizard
After upgrading your SCSI adapter and recording information about the scanner attached to yourcomputer, you are ready to configure the scanner to communicate with Harmony. Use the Harmony
Configuration Wizard to configure your scanner.
How to start the Harmony Configuration Wizard
1. From the Start menu, select All Programs > Toon Boom Harmony 11 > Tools > Configuration
Wizard.
The Harmony Configuration dialog box opens.
How to configure your scanners
1. In the Harmony Configuration dialog box, click Scanners Configuration.

The Scanner dialog box opens.

2. In the Name menu, type or select the scanner's name.
3. In the Model menu, select the scanner model.

40

Toon Boom Harmony 11.1 Scan Guide

4. In the Interface menu, select the scanner interface type.
5. From the SCSI controller number menu, select the SCSI number that identifies your SCSI Adapter.
6. From the SCSI ID menu, select the SCSI number of the scanner.
7. From the logical unit number (LUN) menu, select logical unit number. Due to a scanner's default
configuration and the nature of the device, the LUN should always be zero (0).
8. After you have completed all the fields in this dialog box, click Add.
9. Repeat the previous steps in this procedure for each scanner you want to add.
To remove a scanner from the list, select the scanner from the Name field and click Remove.
10. After you have added all your scanners, click Next.
The Review dialog box opens.

11. Read the summary of how you have configured your scanner and decide if you want to continue.
‣

If the summary is accurate, click Finish to complete the configuration.

‣

If you want to change the configuration, click Back until you reach the dialog box where you
can change the option.

‣

After you make your changes, click Next until you reach the Review dialog box again.

A confirmation message appears when your Scanner configuration file (Scan.conf) is updated.

41

Chapter 5: Configuring Scanners Configuring Scanners for Windows 7

Configuring Scanners for Windows 7
After you have installed the hardware, you will need to run the findscanner utility to obtain information
about your scanner and then configure your scanner.

Running the findscanner Utility
To configure your scanners using the Harmony Configuration Wizard, you need the following scanner
information:•

Adapter ID number•

Path ID•

Target ID•

Logical unit number (LUN)

To obtain this information, run the findscanner utility provided with Harmony. findscanner issues areport including all this information.
How to run the Findscanner utility
1. Locate findscanner.exe. It is stored in \Program Files (x86)\Toon Boom
Animation\Toon Boom Harmony 11\win64\bin.
2. Double-click on the file to start it.
A terminal or command prompt opens and displays a report. In this example, the scanner is on thelast line. The information you need is contained in this segment:
a6;p0;t6;l0.

‣

a6: The Adapter ID number. Its value is 6.

‣

p0: The Path ID. The value is 0.

‣

t6: The Target ID. The value is 6.

‣

l0: The logical unit number (LUN). The value is 0.

3. Record this information so you can enter it into the Harmony Configuration Wizard.

Configuring the Scanner Using the Harmony Scan Configuration Editor
Once you have recorded information about the scanner attached to your computer, you are ready toconfigure your scanner to communicate with Harmony. Use the Harmony Configuration Editor toconfigure your scanner.
How to start the Toon Boom Harmony Configuration Editor
1. From the Start menu, select All Programs >Toon Boom Harmony 10.0 >Tools > Configuration
Editor.

42

Toon Boom Harmony 11.1 Scan Guide

The Configuration Editor dialog box opens.
How to configure your scanners
1. In the Configuration Editor dialog box, select the Scan.conf tab.

2. Scroll down the text until you reach the Examples for Windows 7section.

3. Using the list, locate the model of scanner connected to your computer.
‣

When you find the models that matches, edit the file to remove the pound signs (#) in front ofeach lines of that example.

43

Chapter 5: Configuring Scanners Configuring Scanners for Windows 7‣

If none of the models match the scanner connected to your computer, highlight all the lines ofthe example that is the closest to your scanner model and paste them below that example.
Once the lines are pasted, edit the file by removing the pound signs (#) in front of each line ofthat new example.

Make sure that a pound sign (#) separates the pasted example from the one above and below it.

4. Edit the following lines of the example:
host: Enter the hostname of the computer the scanner is connected to.

44

Toon Boom Harmony 11.1 Scan Guide

If you do not know the hostname of the computer, open a Command Prompt window, type the "hostname"command and press Enter to obtain the name of the computer.

name: Enter a name for the scanner configuration that will appear in the Scan module.
device: Enter the information returned by the findscanner utility. Ex.: a6;p0;t5;l0‣

If the example you just edited matches the scanner model connected to your computer, readthe information entered for the host, name and device, and decide if you want to continue.

‣

If the configuration is accurate, then go to the File menu, save the changes made and close theConfiguration Editor.

‣

If the example you just edited did not match the scanner model connected to your computer,
you will need to edit the following lines as well:model: Enter the model of the scanner connected to the computer.

Make sure the scanner model is included in the supported scanner list found at the beginning of the
Scan.conf document and that the syntax is identical as well.

descr: Enter a short, but meaningful description of the scanner. Ex: B&W Ricoh or Colour Fujitsu.
5. If the information entered for the host, name, device, model and descr entry are accurate, then go to
the File menu, save the changes made to the file and close the Configuration Editor.

Other configurations, like the default Threshold, Gamma, Black&White point and Resolution can also beedited later if needed.

45

Chapter 5: Configuring Scanners Configuring Scanners for Linux

Configuring Scanners for Linux
After you have installed the hardware, you will need to identify the name of the scanner device driverand set permissions for the scanner.

Identifying the Name of the Scanner Device Driver
You must identify the name of the SCSI device that is working with your scanner so that you canconfigure Harmony to communicate with it.
Device drivers all have names starting with /dev/sg. If your scanner is the only generic SCSI device
connected to your system, it is likely that the name of its driver is/dev/sga.
If you are uncertain about the device name, you can use the findscanner utility provided with
Harmony. Use the findscanner utility to probe your SCSI bus for devices. It will tell you the name ofthe device being used by scanners attached to your system.

The device name of your scanner will change if you add, remove or swap other generic SCSI devices.

How to use the findscanner utility to identify your scanner‣Start the findscanner utility. While in the bin folder of your Harmony installation, type thefollowing in a terminal or command prompt:./findscanner
The findscanner utility is installed in /usr/localToonBoomAnimation/harmony_10/ln86_
64/bin/If there are scanners connected to your computer and they are properly installed, the findscanner
utility will return information like the following:/dev/sga type=6: Scanner device RICOH IS450 Vers:1R04/dev/sgb type=6: Scanner device FUJITSU fi-4750Cdm Vers:0G00
If findscanner cannot find SCSI scanners attached to your computer, it will return a statement likethis:
No scsi devices attached
If you get this message, it may indicate that your system could not initialize your SCSI adapter atboot time.
How to make sure your SCSI devices are initialized correctly when you boot Linux
1. Go to the /boot directory and rename the initrd-[version].img file, where [version]
represents the version of your kernel. You can run the uname -r command to find out the versionof your kernel.
cd /boot
mv initrd-2.4.18-3.img noscsi-initrd-2.4.18-3.img

46

Toon Boom Harmony 11.1 Scan Guide

2. Type the following command:/sbin/mkinitrd initrd-2.4.18-3.img 2.4.18-3
This command recreates a new "init ramdisk" image that will load your SCSI driver when your systemstarts.
3. Reboot your system.

Setting Permissions for the Scanner
If you want multiple user accounts to be able to access your scanner, you must modify the permissions
on the device driver.
How to change the permissions on the scanner
1. On a command line, type the following:
chmod 666 /dev/sga/dev/sga must represent the device driver of your scanner.
How to set the permissions on the scanner each time you boot1. Open /etc/rc.d/rc.local in a text editor.
2. Add the following line:
chmod 666 /dev/sga
3. Save and close the file.

47

Chapter 5: Configuring Scanners Configuring Scanners for Mac OS X

Configuring Scanners for Mac OS X
This chapter explains how to configure your scanner to work with Harmony on Mac OS X.
Before you can configure your scanner, your scanner should already be configured, switched on, andconnected to your system.
After your scanner is configured, you must modify the hardware so Harmony can align images scanned
using autofeed.

Modifying the Scan.conf File
After you have installed your scanner hardware, you must configure your scanner to communicate with
Harmony. To do this, you must find the name of your scanner using the Find Scanner Utility. Then, youmust add this name to the Scan.conf file.
How to modify the Scan.conf file
1. Open a terminal and type the following:
findscanner.

The path to the Harmony's terminal applications must be registered for this process to work. Refer tothe Mac OS X Installation chapter to learn how to register the path to the Terminal application.

The findscanner utility reports the following information:
Device found:<FUJITSU/M4097Ddim>
The device found must be copied into the Scan.conf file, including the angle brackets.
2. Modify the Scan.conf file with the Harmony Configuration Editor. Open a Finder and selectApplications > Toon Boom Harmony 11 > Tools > Configuration Editor.
3. In the Harmony Configuration Editor, select the Scan.conf tab.
The following is an example of entries in a Scan.conf file for a Fujitsu scanner on Mac OS X.
host: scan1
name: Fujitsu BW
model: Fujitsu_M4097D
device: <FUJITSU/M4097Ddim>
descr: The scanner to use for black & white and greyscale scans.
defaultGamma: .89
defaultResolution: 200
The following options must be included in the Scan.conf file:•

host: [hostName]

where [hostName] is the name of the machine that the scanner is attached to.

48

Toon Boom Harmony 11.1 Scan Guide•

name: [scannerName]

where [scannerName] is the name you want the scanner to be listed as in the scanner drop-list in
the Harmony.
•device: <device name>where <device name> is the name the findscanner utility reports. You must include the angle
brackets.
•model:[modelName]

where [modelName] is the model name of your scanner (the name is case sensitive and there can be
no spaces separating the name and the number). Following is a list of supported scanners.
Epson_836XL
Epson_1640XL
Epson_GT-15000
Fujitsu_M3096G
Fujitsu_M4097D
Fujitsu_fi4750C
Fujitsu_fi5750C
Fujitsu_fi6770
Ricoh_IS330
Ricoh_IS420
Ricoh_IS430
Ricoh_IS450
Ricoh_IS760
TWAIN

49

Chapter 5: Configuring Scanners Configuring Scan.conf to Communicate with the Scanner

Configuring Scan.conf to Communicate with the ScannerOnce your scanner is set up and you know the device driver name, brand and model, you are ready toconfigure the Scan.conf file so that the Harmony can communicate with it. The Scan.conf filecontains a number of configuration parameters you can use to control the communication between
your scanner and the Harmony.
The Harmony Configuration Wizard updates the Scan.conf file with the required information. If
there are other variables you want to modify in this file, use the Harmony Configuration Editor.

Location of the Scan.conf File
Windows 7: C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony
11\etcMac OS X:
1. Application > Toon Boom Harmony 11 > tba > etc
2. Hold down Ctrl, click Shared Modules and select Show Packages Contents.
3. Open the etc folder.
Linux: /usr/local/ToonBoomAnimation/harmony_10.0/etc

Location of Original Default Scan.conf File
Windows 7: C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony
10.0\resources\samples
Mac OS X: Applications > Toon Boom Harmony 11 > tba > resources > samples
Linux: /usr/local/ToonBoomAnimation/harmony_11.0/resources/samples
Here is an example of entries in a Scan.conf file for a Ricoh scanner on Linux.
host: scan-1
name: My_Ricoh_IS450DE_Scanner
descr: The scanner to use for black & white and greyscale scans.
device: /dev/sga
model: Ricoh_IS450DE
defaultThreshold: 80
defaultResolution: 200
registrationStrictness: Loose
The following options must be included in the Scan.conf file:•

host: [hostName]

where [hostName] is the name of the machine the scanner is attached to.
•

name: [scannerName]

where [scannerName] is the name you want the scanner to be listed as in the Scanner menu in the
Harmony.

50

Toon Boom Harmony 11.1 Scan Guide•

device:•Linux: /dev/[filename]where [filename] is the filename of the device driver for your scanner.
•

Windows: scX;dY;lZ
The SCSI identifier for the scanner.
X=controller number (normally 0)
Y= device number (as set on the scanner)
Z= The logical unit (normally 0)
ex: device: sc0;d5;l0 (if the scanner is set to scsi id 5)•

Mac OS X: <device name>where <device name> is the name findscanner reports. You must include the angle brackets.

•model:[modelName]

where [modelName] is model name of your scanner (the name is case sensitive and there can be no
spaces separating the name and the number). Following is a list of supported scanners.
Epson_1640XL
Epson_GT-15000
Fujitsu_M3096G
Fujitsu_M4097D
Fujitsu_fi4750C
Fujitsu_fi5750C
Fujitsu_fi6770
Ricoh_IS330
Ricoh_IS420
Ricoh_IS430
Ricoh_IS450
Ricoh_IS760
TWAIN
The following are optional additions to the scanner description.
•

descr: [scannerDescription]

Where [scannerDescription] is a description of the scanner, which appears in the Scanner
Information dialog box in the Scan window. This text must be all on one line.
•

defaultThreshold: [value]

Where [value] is the default value for threshold for black and white scanning. The value should be an
integer (0 ≤ [value] ≤ 255). The default threshold value at installation is 100 if no value is specified.

51

Chapter 5: Configuring Scanners Configuring Scan.conf to Communicate with the Scanner•

defaultBlackPoint: [value]

Where [value] is the colour value (0 < [value] < 255) that the Scan module considers to be black. The
Scan module forces any colour darker than this value to black. If no value is specified, it defaults to20.
•

defaultWhitePoint: [value]

Where [value] defines the colour value (0 < [value] < 255) that the Scan module considers white. The
Scan module forces any colour lighter than this value to white. If no value is specified, it defaults to235.
•

defaultGamma: [value]

Where [value] is the default value for colour and grayscale gamma correction(0.0 < [value] ≤ 2.55) on the scanner. The default gamma value at installation is 1.0 if no value isspecified.
•defaultResolution: [value]

Where [value] is the default resolution in dpi (dots per inch) for the scanner. The value should be an
integer that is one of the scanner's legal resolutions. The default resolution value at installation is300. For Fujitsu and Ricoh scanners, 300 DPI is appropriate. For colour scanners, like the Epson,
150 DPI is suggested.
•defaultPegSide: [value]

Where [value] defines the default value in the Peg-Side menu when you select the scanner. You canchoose between Top, Right, Left or Bottom.
•

registrationStrictness: [level]

Where [level] defines how exact the location of the peg holes must be for the software to recognize
them. You have two values to choose from:••

Strict: The peg holes must be in a tightly defined area to be recognized. This is the default
setting.

•

Loose: The peg holes can be anywhere in a larger area to be recognized. This setting is
recommended.
pegPitch: [value]

Where [value] is the number of decimal places permitted when defining the distance in inches
between side pegs. The peg pitch can be defined to fix splicing problems when aligning pan cels.
The default value is 8 (e.g., a distance of 0.12345678 could be defined).
•side0CleanSize: [value]side1CleanSize: [value]
side2CleanSize: [value]
side3CleanSize: [value]

Where [value] is the distance in inches from the edge of the drawing that will not be included in thescan. Including these values can save vectorization time and remove dirtiness at the edges of adrawing. Side "0" is the side with peg holes. Remaining sides are numbered in clockwise fashion.

52

Toon Boom Harmony 11.1 Scan Guide

Adapting the Scanner Hardware
Before using your scanner, you must make a few minor adjustments to make sure it can handle thespecial types of animation paper you will be using.

Modifying the ADF Paper ChuteOn the ADF paper chutes of supported Fujitsu scanners, the paper guides are connected to eachother by a cog wheel that keeps the paper guides and the drawings centred on the chute.
Adjustments must be made to this type of Fujitsu scanner to avoid problems during the scanning
process.
To compensate for the centred scanning on the ADF chute of Fujitsu scanners, do one of the following:•

Modifying the Scan.conf File for Centred ADF Scanning below (requires no hardware modification)•

Removing the Cog Wheel on Paper Chute on the next page•

Adding a Paper Guide to Your ADF Scanner on the next page

Modifying the Scan.conf File for Centred ADF ScanningIf you do not want to modify the ADF chute so that it is aligned towards the back of the scanner, you
can use the leftOffset option in the Scan.conf file. To calculate the leftOffset option,
consider that the paper chute on all supported Fujitsu scanners are 12 inches (2.54 cm) wide . If yourpaper is 10.5 inches (26.67 cm) wide, the difference between the chute and the paper is 1.5 inches (3.81cm). Since this difference is distributed on both sides of the paper chute, the offset from either edge is
0.75 inches (1.90 cm). Therefore, the leftOffset option is 0.75 inches (1.90 cm).
The leftOffset option was added to this sample of the Scan.conf file:
host: scan-1
name: Fujitsu10.5
descr: The scanner to use for black & white and greyscale scans.
device: sc1;d5;l0model: Fujitsu_fi4750C
defaultThreshold: 80
defaultResolution: 200
registrationStrictness: Loose
leftOffset: 0.75
You can add additional entries in the Scan.conf file to support paper of different sizes. For example:
host: scan-1
name: Fujitsu8
descr: The scanner to use for black & white and greyscale scans.
device: sc1;d5;l0model: Fujitsu_fi4750C
defaultThreshold: 80
defaultResolution: 200
registrationStrictness: Loose
leftOffset: 253

Chapter 5: Configuring Scanners Adapting the Scanner Hardware

Removing the Cog Wheel on Paper ChuteIf you don't want to modify the Scan.conf file, you can remove the cog wheel so the paper guides
can slide independently. This allows you to position the paper guide closest to the back of the scanner
as far as it can go towards the back of the scanner. You can then slide the other paper guide up to
meet the bottom edge of the stack of drawings to keep them aligned.

How to remove the cog wheel
1. Remove the paper chute from the scanner.
2. Remove the screw that attaches the cog wheel to the paper chute.
After you remove the cog, the paper guides should be able to slide independently of each other.

Adding a Paper Guide to Your ADF ScannerInstead of removing the cog wheel on the ADF paper chute, you can make a paper guide to place
between the existing paper guides to keep the stack of drawings in the proper alignment in the paper
chute.
To perform this procedure, you will need the following materials:•

A paper guide made of cardboard, a block of wood, or similar material.

•

Adhesive tape to secure the paper guide to the paper chute.

How to place a paper guide on your scanner
1. Open the ADF paper guides to their widest position.
Place the paper guide closest to the back of the scanner as far out as it can go (toward the back of
the scanner).
If you did not remove the cog wheel, this will make for a very wide paper chute, wider than most of
your animation paper.
Now you must create an intermediate paper guide to hold your drawings in place.
2. Place a stack of drawings in the paper chute so that they are touching the back paper guide. Make
sure the back paper guide is as far back as it can go.
3. Position the paper guide you created to secure the other edge of the paper stack.
4. Secure the paper guide with tape.

54

Toon Boom Harmony 11.1 Scan Guide

Installing a Strip of Black Tape on the ADF Paper Path
When you scan drawings with the Harmony Scanmodule, drawings on paper become digital images inthe Harmony system. These digital images must be properly aligned during the scan process to ensurethat the animation flows smoothly from frame to frame in the final output.

•

If you want to scan many drawings using the ADF chute on your scanner, you must use the Optical
Registration option in the Scan module to automatically align your drawings.
When you select the Optical Registration option, the Scan module identifies the peg holes to alignthe drawings.
You can also use the Optical Registration option if you want to manually scan a drawing on the
flatbed part of the scanner.

•

If you have a peg bar attached to your scanner, you don't have to use optical registration because
the drawings will be aligned by the peg bar. However, you will have to scan your drawings one at atime.

Peg holes in your drawings must be filled with black in the final scanned image for the opticalregistration to be able to locate them. Your scanner must be modified prior to scanning to ensure
black peg holes appear in the scanned image.
For ADF Scanning
Tape a piece of dark paper to the ADF feeder in the position where the peg holes will pass as they arescanned.

55

Chapter 5: Configuring Scanners Adapting the Scanner Hardware

If you don't place the black tape on the ADF paper path, the peg holes in the drawing pass in front of awhite background. This does not provide enough contrast for the Scan module to distinguish where
the peg holes are and it will not be able to register and align the autofeed drawings.
For Manual Scanning
Tape a piece of dark paper to the scanner cover above the position of the peg holes.
RICOH Scanner

Fujitsu Scanner - ADF

56

Toon Boom Harmony 11.1 Scan Guide

Fujitsu Scanner - Cover

Before you perform this procedure, you need the following materials:•

A strip of black adhesive tape approximately 1.25 inches (3.5 cm) by 0.75 inches (2 cm). Black
plastic electrician's tape is fine.

•

A sheet of drawing paper with field size and peg hole locations identical to the type that you intend
to scan with the autofeeder.

To install the tape on the ADF paper path:
1. Turn off the scanner's power and open the ADF cover.

2. Place the paper guides in their scanning position. This will depend on your scanner and any
modifications you made to it.
3. Place the drawing paper in the paper chute with the peg holes toward the back of the scanner.
The top edge of the paper should touch the paper guide closest to the back of the scanner.
4. Slide the paper into ADF chute.
5. Place the strip of black tape across the width of the white strip on the inside of the ADF cover. Use
the peg holes in the drawing paper as a visual guide.

57

Chapter 5: Configuring Scanners Adapting the Scanner Hardware

6. Close the ADF cover and scan a few test drawings to see that the Scan module can identify the peg
holes.

Mounting the Peg Bar and Calibrating the Scanner
Autofed and manually pegged drawings must register against each other if you intend to use bothscanning methods. Therefore, you must calibrate the scanner so that it can register the peg holes
accurately using the peg bar.
Before you perform this procedure, you will need the following materials:•

An ultra-thin peg bar. Suggestion: Audio-Visual Stainless Steel Pegbar (catalog number AP105)•

Accurate ACME standard registration•

3-peg, single-field length (0.05" x 1.5" x 12.0") (1.27mm x 38 mm x 304.7mm)•

Low brass pegs (1/16" in height) (1.58 mm in height)•

Lightweight sprung stainless steel base•

Ideal for work requiring exposure on a process camera, print down frame or scanning bed
This is obtainable from Chromacolour International www.chromacolour.com•

A drawing with field size and peg hole locations identical to the type you intend to scan.
Instead of using a drawing of a character or object, you may find it helpful to create a test
"drawing" by placing a sheet of drawing paper over a field chart and tracing several heavy line
segments from the field chart.
For more accurate calibration, draw lines from the centre to the edges of the paper. This will give
more reference points at various locations on the paper. For example, trace over the centre X andseveral corners of the fields from the centre out towards the edges of the field chart. Then peg andautofeed the test drawing as described in the following procedure.

58

Toon Boom Harmony 11.1 Scan Guide

Before calibrating the scanner:‣

Create a small scene in Harmony using the test drawing.

‣

Using the Control Center module, create a job that has one scene.

‣

Using Harmony Stage, create an exposure sheet for the job that has two drawing columns(one for the drawing you will autofeed and one for the drawing you will manually peg before
scanning).

To mount the peg bar and calibrate the scanner:
1. Create a test scene.
2. Open the Scan module and open the elements you created.
3. Perform an Autofeed scan of the test drawing in the autofeed element, with Optical Registration
enabled.
4. After the drawing has vectorized, load it in Stage by reopening the scene.
5. Loosely tape the peg bar to the scanner bed (centre the bar horizontally on the scanner bed; movethe bar vertically on the top of the scanner bed).
6. Scan the pegged drawing with the Autofeed feature off.
7. After the drawings has vectorized, load it in Harmony Stageby reopening the scene, and comparing
its alignment with the drawing scanned in step 4.
8. If the two images do not align, move the peg bar and rescan the pegged drawing again.
9. Repeat these steps until you have aligned the drawings. When the peg bar is in the desired position,
securely attach the peg bar to the scanner bed. Keep the test drawing for future use.

59

Toon Boom Harmony 11.1 Scan Guide

60