Learn to Animate

Troubleshooting

Troubleshoot problems with OpenToonz.
If a Vector shape won't fill:
  1. Check the Fill Tool's settings:
    1. Are you using the type correctly?
      1. Normal: click in a closed shape to fill
      2. Rectangular: click and drag around closed shapes to fill
      3. Freehand: draw around closed shapes to fill
      4. Polyline: left-click at multiple points around closed shapes until the polyline forms a closed shape to fill
    2. Are you using the correct mode?
      1. Lines will only fill lines
      2. Areas will only fill areas
      3. Lines and Areas fills both
    3. Is "Frame Range" checked?
      1. With "Frame Range" enabled, you need to use the fill tool on a minimum of 2 separate drawings/frames
  2. Is a color selected (other than the transparent background style)?
  3. Is a stroke style selected?
    • Under the Vector tab, generated brushes with a curved, diagonal icon like the following are only for brush strokes
    • Under the Vector tab, trail styles are only for brush strokes
    • Under the Vector tab, vector brushes are only for brush strokes
  4. Is the fill color opaque?
    1. In the style editor, check the alpha value (A)
      1. 0 = completely transparent
      2. 255 = completely opaque
  5. Is the shape closed?
    1. Enable Gap Check:
      1. Gap Check shows gaps in vector drawings
        1. View → Gap Check
        2. The gap distance is set in the "Tape" tool (T)
    2. or Enable Fill Check:
      1. Fill Check displays fillable areas in grey
        1. View → Fill Check
  1. Remove any gaps with one of the following:
    1. The Brush Tool (B)
      1. Draw a stroke to fill in the gap
    2. The Tape Tool (T)
      1. Make sure "Join Vectors" is checked
      2. If the type is set to "Normal":
        1. Choose the mode that applies best then click and drag to tape the gap closed
          1. "Endpoint to Endpoint" is best for connecting the ends of lines together
          2. "Endpoint to Line" can connect the end of a line to any point along a line
          3. Line to Line can connect any 2 points on a line or lines together
      3. If the type is set to rectangular:
        1. Click and drag around the gap to connect the 2 points
        2. If the connection is not perfect, try using CMD-Z to undo and try changing the "Distance" value before trying again
    3. The Control Point Editor (C)
      1. Click and drag to reposition anchor points (to fill the gap)
    4. The Iron Tool (for small areas of overlap in the endpoints or different stroke sizes in the endpoints)
      1. Click and drag back and forth over the endpoint area
Simplifying Vectors can be incompatible with the automated "Inbetweener" function but resolves difficult fill issues the vast majority of the time.
  1. If there are overlapping endpoints to remove:
    1. In the Viewer, select the vector shape(s) with the "Selection Tool" (S)
    2. Right-click on the selection and choose "Remove Vector Overflow"
  2. Select the cell(s) that you want to simplify
  3. In the top menu go to: Level → "Replace Vectors with Simplified Vectors"
If a Toonz raster fill spreads across the wrong area:
  1. Make sure the shape you want to fill (or not fill) is a closed shape
  2. Fill any gaps with the Brush or Paint Brush Tools
If a Raster shape won't fill:

Raster levels cannot be filled. Use a Vector or Toonz Raster level to make filled shapes.

In order to render video, an add-on called FFmpeg is needed. If you do not have FFmpeg installed - or if it is incorrectly linked, it will be impossible to load or render video.

  1. Add FFmpeg to the computer in order to export video:
    1. Download FFmpeg (it is available on the shared class folder and in Google Classroom)
    2. In the top menu of OpenToonz, go to OpenToonz → Preferences
      1. Under "Import/Export"
        1. set FFmpeg path (to enable video import and export)
          1. download FFmpeg and move to "Documents"
          2. under Import/Export, click on the ... next to "FFmpeg path"
          3. use the "File Browser" to find the correct folder

        2. change FFmpeg Timeout to at least 600
    3. Close and reopen OpenToonz
  1. Delete the rendered video
  2. Increase the ffmpeg timeout
    1. In the program menu, go to OpenToonz → Preference
    2. Select Import/Export
    3. Increase the value next to Ffmpeg timeout (I find 600 is a good place to start)
  1. If you did not set a specific output location (and did not use "Fast Render to Mp4"), the file(s) should be located in the project's output folder
    1. By default on a Mac this will be located in: Applications/OpenToonz/OpenToonz_1.1_stuff/projects/project_name/outputs
    2. If you your project folder in located in Documents: Documents/OpenToonz/project_name/outputs
    3. If you used "Fast Render to MP4", your file should be located on the desktop
  1. Make sure render visibility is toggled on for the level and not off
  2. If using FX, make sure the level is connected to the X-sheet in the FX Schematic
If an image sequence is not named correctly, it will not load as a single level. Accepted name formats are as follows:
  1. name_number.filetype
    • name_0001.png
  2. name.number.filetype
    • name.0001.jpg
  3. Sequences currently cannot start at 0
To rename an image sequence into an accepted format, follow the directions here under the "File Names" tab.
Animated gif's rely on part of the FFmpeg package (called FFprobe). If you've downloaded just FFmpeg on it's own without FFprobe, animated gifs will only load as a single frame.
  1. If you have not set up FFmpeg yet, go to Preferences:
    1. Under "Import/Export"
      1. set FFmpeg path (to enable video import and export)
        1. download FFmpeg and move to "Documents"
        2. under Import/Export, click on the ... next to "FFmpeg path"
        3. use the "File Browser" to find the correct folder

      2. change FFmpeg Timeout to at least 600
  2. If you have FFmpeg but are missing FFprobe:
    1. Download FFprobe (it is located in the FFmpeg folder available on the shared class server and on Google Classroom)
    2. Using Finder, make sure to move FFprobe into your FFmpeg folder
  3. Restart OpenToonz
  1. Is the selected level locked or hidden ?
  2. Is the selected style a visible style?
    1. Is there enough opacity to see the color?
      1. In the Style Editor, check the alpha (A) value:
        1. 0 = completely transparent
        2. 255 = completely opaque
    2. Do you have the transparent background style selected?
  3. Is the selected style a fill style?
    • Generated vector styles with a square icon image like the following are only for fill areas:
  4. Are you using the correct brush type for the level?
    1. Raster brushes only work for Raster levels - on Vector & Toonz Raster levels, the Raster brush should be set to "No brush"
    2. Vector brushes only work for Vector levels - on Raster and Toonz Raster levels, the Vector brush is ignored
Sometimes after using a tablet with OpenToonz and then going back to using a mouse, the beginning of each brush stroke becomes obscured by a large dot. To prevent this, turn off "Pressure" in the Tool Option Bar when using a mouse.
If you have two overlapping...