Export to Harmony Dialog Box

The Export to Harmony dialog allows you to export your animatic into a set of Harmony scenes. After the export, you can open the scenes Toon Boom Harmony right away and kickstart the production of your animation project. If you are working with Harmony Server, you can export a package of scenes that can be imported into your database using Control Center. The resulting Harmony scenes will be the same length as the scenes in your Storyboard Pro project, they will contain each of their panels so that you may animate over them, and they will contain their respective part of the animatic's soundtrack.

You can choose to export your animatic in rendered frames, which will not be editable in Harmony and can only be used as reference, or to export the drawings, 3D objects, images, videos and camera movements of each scene in your project directly into the Harmony scenes, allowing you to reuse its elements in Harmony. If you are rendering your animatic, you can choose whether you want to export one scene for the whole project, for each sequence or for each act, whereas if you want to export original scenes, you can only export one Harmony scene for each scene in your animatic.

TIP If you want to exclude some elements from getting exported to Storyboard Pro, you can select layers in the Layers view and uncheck the Export To: Toon Boom option for these layers.
NOTES
  • Transitions in your project are not exported to Harmony.
Parameter Description

Destination Path

Path

Allows you to specify the directory in which to save the exported files. You can click on the Browse button right of the field to browse your file system and select the destination folder.

File Pattern

Allows you to enter the prefix or the pattern for the names of the exported files. You can leave this field blank to use the default file naming pattern, type in a file name to use it as a prefix, or type a full pattern using the following variables:

  • %t - Project title
  • %a - Act number
  • %q - Sequence number
  • %s - Scene number
TIP Numbers used in file naming patterns are automatically padded by zeros as needed. You can type a number between the % sign and the variable letter to determine the amount of characters you want the variable to use. For example, with the variable %4s, scene 1 would appear as scene 0001.

Export Type

Format

Lets you select whether to export your animatic into Harmony Offline scenes, Harmony Database scenes or Animate/Animate Pro scenes.

Version

When exporting Harmony Offline or Harmony Database scenes, lets you select whether to export scenes that are compatible with Harmony version 7.8 or with Harmony version 9.2 or Higher.

Export Style

Rendered Animatic

Renders the animatic into a sequence of bitmap images that are assembled into the exported Harmony scenes. This ensures that the content of your animatic is accurately rendered in Harmony, especially if you intend to use an older version.

Resolution: Allows you to select the resolution of rendered frames relative to the project resolution between the following options: Full Size, Half Size or Quarter Size.

Generate One Scene: Allows you to select how to separate the project into Harmony scenes:

  • Per Scene: Generates one scene for each scene in your project.
  • Per Sequence: Generates one scene for each sequence in your project.
  • Per Act: Generates one scene for each act in your project.

Optimize Still Images: When there is no animation or camera movement for a certain time span, a single drawing is rendered and its exposure is rendered until there is movement. If this option is disabled, one frame is rendered for every frame in your animatic, regardless of if there is movement or not.

Animatic on Top: If you generate scenes based on sequences or acts, this option becomes available. When enabled, the animatic is rendered and placed as the top layer and column in Harmony or Animate.

Original Scene

Exports the animatic directly into Harmony scenes without rendering it. This preserves the layers, drawings, 3D objects, images, videos and camera movements so that they can be used in Harmony. One scene will be generated for each scene in the project.

Nest Panels in Symbols: Upon export to Harmony or Animate, the panel's content will be nested inside symbols. Instead of having several layers in your root timeline, you will have a single one. You will need to enter the symbol to edit its content.

Add Camera Reference Layer: Adds a layer containing the different camera frames on top of the other layers to use as a reference in Harmony and Animate.

Apply Transformation on Drawings: Applies transformation on the first and last position of each panel. The in-between animation will be lost.

Export Range Tab

All

Exports the entire storyboard.

Selected Scenes

Select this option to export a specific selection of scenes. Then, click on the Select button to open the Scenes Picker dialog box, in which you can:

  • Type the number of a sequence or of a scene in the Sequence or Scene fields in the Filter section, to only show matching sequences or matching scenes in the list.
  • Click and drag to select a range of scenes.
  • Hold the Ctrl key and click on each scene you want to add to your selection.
  • Hold the Shift key, then click on the first scene and the last scene you want to add to your selection, to select every scene between those two scenes inclusively.
  • If your project has sequences, click on a sequence to select every scene in that sequence.

Current Scene

Exports only the currently selected scene.

Sounds Tab

Processing

  • Keep Original Files: Copies the sound clips from your project into the exported scenes, without mixing them.
  • Process Audio Tracks Individually: Creates a mixed sound file for each audio track and stores each sound file into its own sound layer in the exported scene.
  • Merge All Audio Tracks: Creates a single sound file with all the audio tracks merged and stores it into a single sound layer in the exported scene.
  • Process Audio Tracks Individually and Merged: Creates a single sound file for each audio track and stores each sound file into its own sound layer, then adds an extra sound layer with all the audio tracks merged together.

File Pattern

  • Allows you to enter the prefix or the pattern for the names of the exported files. You can leave this field blank to use the default file naming pattern, type in a file name to use it as a prefix, or type a full pattern using the following variables:
    • %t - Project title
    • %a - Act number
    • %q - Sequence number
    • %s - Scene number
    • %n - Sound track number
    TIP Numbers used in file naming patterns are automatically padded by zeros as needed. You can type a number between the % sign and the variable letter to determine the amount of characters you want the variable to use. For example, with the variable %4s, scene 1 would appear as scene 0001.

    Sample Rate

    Sets the frequency rate of the exported audio files. It is recommended to export sound files at the rate at which they were originally created. For reference, the standard sample rate is 48.0 kHz for broadcasting and DVD.

    Bit Depth

    Sets the precision level of each wavelength in the sound file. The standard bit depth is 16 bit. Setting this to 8 bit will cut the size of audio files in half, but will significantly impact sound quality.

    NOTE On Windows, audio can only be exported in 16 bit unless QuickTime Player is installed.

    Channels

    Allows you to select whether to export sound in Mono or Stereo. Stereo sound uses a separate track for the left and right speakers, which allows to simulate a realistic sound environment. Mono uses a single track for both speakers, which saves disk space.

    Burn-In Tab

    Print Time Code

    Prints the project timecode on the video as an overlay on your video.

    Print Scene Names and Panel Numbers

    Prints the scene names and panel numbers as an overlay on your video.

    Print Additional Duration

    Prints another time code counting the time for the current panel, scene or sequence, depending on what is selected in the Repeat drop-down.

    Units

    Displays additional duration information using Time Code or Frames units.

    Repeat

    Displays additional duration information per panel, scene or sequence.

    Camera Grid Tab

    Title Safe Area

    Prints the Title Safe Area over the picture. By default, this area is 20% smaller than the camera frame. It is used as a guideline of the area that CRT displays might crop out of the picture. Visual elements such as text and logos should be placed within this area.

    NOTE The size of this area can be changed in the Camera tab of the Preferences dialog—see Camera Preferences.

    Action Safe Area

    Prints the Action Safe Area over the picture. By default, this area is 10% smaller than the camera frame. It is used as a guideline of the area that CRT displays might crop out of the picture. Characters and action should be placed within this area.

    NOTE The size of this area can be changed in the Camera tab of the Preferences dialog—see Camera Preferences.

    4:3 Safety

    Prints the title safe area and the action safe area for the 4:3 camera frame over the exported image. They can be used to position elements in projects that are meant to be displayed in both widescreen and 4:3 proportions.

    4:3 Reference

    Prints the 4:3 camera frame over the exported image. This frame corresponds to the camera frame if the aspect ratio of the picture was 4:3. It can be used to position elements in projects that are meant to be displayed in both widescreen and 4:3 proportions.

    Scene Options Tab  

    Custom Write Node Parameters

    When enabled, you can use the options below to set the parameters of the Write node for the exported Harmony scenes, so that you won't have to configure the Write node for each exported scene individually in Harmony.

    If this option is disabled, the Write node in the exported Storyboard Pro scenes will have the following default options:

    • Drawing Folder: frames
    • Drawing Filename: final-
    • Drawing Type: TGA

    Image Render Path

    The path to the folder in which to save the rendered frames. This path can be absolute or relative to the scene's folder. For example, the default path for rendered frames is frames, which means the images are saved in the frames subfolder of the scene folder. If you want to select an absolute path, you can click on the Browse button at the right of the text field and select the folder in which your scenes should export their frames.

    You can type a simple path, so that every exported scene has the same image render path, or you can define a different image render path for each scene by typing in a pattern using the following variables:

    • %t - Project title
    • %a - Act number
    • %q - Sequence number
    • %s - Scene number

    Image Filename

    The prefix for the file name of each exported frame. Frames will be named with this value, followed by the frame number and their image type extension. It is recommended to leave the hyphen (-) at the end of the prefix to separate the prefix from the frame number.

    You can type a simple prefix, so that it is the same for all the exported scenes, or you can define a different prefix for each scene by typing in a pattern using the following variables:

    • %t - Project title
    • %a - Act number
    • %q - Sequence number
    • %s - Scene number

    Image Format

    The image format in which the exported frames will be saved. Storyboard Pro can export in the following formats:

    Format Specification Description
    TGA Full colour

    Truevision TGA/TARGA (*.tga)

    A standard image format with lossless compression and support for transparency.

    TGA files use more disk space than PNG files, but rendering in TGA is faster.

    TGA1 Greyscale
    TGA3 Full colour
    TGA4 Full colour with transparency
    SGI Full colour / 8 bits per channel

    Silicon Graphics Image (*.sgi)

    A highly capable format with lossless compression as well as support for double precision and transparency.

    SGI1 Greyscale / 8 bits per channel
    SGI3 Full colour / 8 bits per channel
    SGI4 Full colour with transparency / 8 bits per channel
    SGIDP Full colour / 16 bits per channel
    SGIDP3 Full colour / 16 bits per channel
    SGIDP4 Full colour with transparency / 16 bits per channel
    PSD Full colour / 8 bits per channel

    Photoshop Document (*.psd)

    An Adobe Photoshop proprietary format used for image editing.

    PSD files exported by Harmony contain a single background layer with the rasterized image.

    NOTE PSD files exported from Storyboard Pro are tagged with their colour space information in their metadata, except for PSD files exported in greyscale.
    PSD1 Greyscale / 8 bits per channel
    PSD3 Full colour / 8 bits per channel
    PSD4 Full colour with transparency / 8 bits per channel
    PSDDP Full colour / 16 bits per channel
    PSDDP1 Greyscale / 16 bits per channel
    PSDDP3 Full colour / 16 bits per channel
    PSDDP4 Full colour with transparency / 16 bits per channel
    YUV

    Y'UV frame (*.yuv)

    A legacy format optimized for NTSC television. The image information is encoded in the Y'UV color space, which means Luma (Y') and Chrominance (UV).

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

    PAL frame (*.pal)

    A legacy format optimized for PAL television.

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

    Toon Boom Scan Files (*.scan)

    A Toon Boom proprietary format used by Scan to store scanned image information along with its registration (peg), resolution and field chart metadata. SCAN files are in gresycale.

    PNG Full colour / 8 bits per channel

    Portable Network Graphics (*.png)

    A highly portable image format with high lossless compression as well as support for transparency and double-precision. PNG is typically used for Web applications, graphical user interfaces and image sharing.

    Rendering in PNG takes more time than rendering in TGA or in uncompressed image formats, but saves a lot of disk space.

    NOTE PNG files exported from Storyboard Pro are tagged with their colour space information in their metadata.
    PNG4 Full colour with transparency / 8 bits per channel
    PNGDP Full colour / 16 bits per channel
    PNGDP3 Full colour / 16 bits per channel
    PNGDP4 Full colour with transparency / 16 bits per channel
    JPG

    Jpeg (*.jpg)

    A very compact image format with lossy compression. It is typically used for Web pages and photo sharing. Because it does not preserve image quality, it is recommended to never render in Jpeg format unless you are exporting stills for a Web page or are making quick render tests.

    BMP Full colour

    Bitmap (*.bmp)

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

    BMP4 Full colour with transparency
    OPT Full colour

    Toon Boom Optimized image (*.opt)

    A legacy Toon Boom proprietary format that stores bitmap image data with lossless compression. It supports transparency.

    OPT1 Greyscale
    OPT3 Full colour
    OPT4 Full colour with transparency
    VAR

    Toon Boom Variable Header image (*.var)

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

    TIF

    Tagged Image File Format (*.tiff)

    An image format with many compression and encoding settings. It is often used for image exchange in visual arts and publishing.

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

    DPX 8 bits per channel / Full color / RGB channel order

    Digital Picture Exchange (*.dpx)

    A professional photo format that supports various different approaches to storing colour information, which can be used for storing, exchanging and editing raw information recorded by cameras. It is commonly used in film production.

    DPX3_8 8 bits per channel / Full color / RGB channel order
    DPX3_10 10 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
    EXR 16 lines Zip compression

    OpenEXR (*.exr)

    A highly capable deep image format. Each pixel in an EXR file is exported with its Z-depth information. Additionally, if a pixel is semi-transparent, the color and depth information of pixels further back is stored along with it. If your scene has multiplane or 3D elements, this format can be used for compositing your animation with other graphical elements in 3D animation software.

    NOTES
    • OpenEXR files exported from Storyboard Pro are tagged with the white point and primaries coordinates for their colour space.
    • OpenEXR files are always exported by Storyboard Pro always have 1 line Zip compression if they contain a 3D image.
    EXR_ZIP_1LINE 1 line Zip compression
    PDF

    Portable Document File (*.pdf)

    Typically, PDF files are used to store, archive, share and print documents. However, Harmony uses the PDF format for its capability to store bitmap images and vector graphics.

    If the write node is connected to a vector drawing layer or to a vector composite, the exported PDF files will contain the image as a vector graphic. It will ignore bitmap layers, effects and deformations. Otherwise, the PDF files will contain the rendered image as a bitmap.

    DTEX

    Deep Texture (*.dtex)

    A commonly used deep image format. Each pixel in an DTEX file is exported with its Z-depth information. Additionally, if a pixel is semi-transparent, the color and depth information of pixels further back is stored along with it. If your scene has multiplane or 3D elements, this format can be used for compositing your animation with other graphical elements in 3D animation software.

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

    Open folder after export

    Opens the folder in which files were exported in a file browser once the export is done.