
An OpenToonz cleanup output can exist even when pegbar autocentering failed. The 1.7.1 manual says a recognition failure raises an error but the other cleanup settings still process the drawings. Treat successful file creation and successful registration as separate checks.
Key Takeaways
- A processed TLV does not prove pegbar alignment succeeded.
- Check the scanned holes, their specified side and the Field Guide.
- Compare registration before processing a whole sequence.
Read the warning before accepting the level
In the official cleanup guide, Autocenter aligns drawings from the shape and position of the pegbar holes. Rotate, Flip and other cleanup settings can still affect a drawing when that alignment fails. A clean-looking outline therefore cannot dismiss the error.
Keep the original scans and save a separate scene before diagnosis. Record which drawings reported the failure. Do not repeatedly clean the already processed output in an attempt to rediscover holes that were cropped from the source.
Preview one failed drawing
Open Scan & Cleanup > Cleanup Settings. With a relevant source drawing selected, enable Autocenter, set Pegbar Holes to the side containing the scanned holes, and choose the Field Guide matching the intended guide and hole type. These controls are documented; a guessed camera offset is not a replacement for the intended registration method.
Use Scan & Cleanup > Preview Cleanup. Check whether the source actually contains complete recognizable holes in the expected position. If they are absent, return to the acquisition source or plan a separately reviewed alignment method. Changing line sharpness will not recover the missing registration evidence.
Proposed check: a held head and moving mouth
Suppose scanned mouth drawings should sit under a held head. One cleaned drawing has good lines but appears vertically displaced. Compare that frame with its neighbors while keeping the head fixed. This is a proposed diagnostic, not a tested sequence.
Correct the hole-side or guide mismatch on a copy and preview again. Observe both the registration and the line result. If alignment remains uncertain, keep that frame flagged rather than accepting it merely because another TLV was produced.
Accept position as well as clean lines
Inspect the first drawing, each warned drawing and a representative transition in the scene. Compare a stable anatomical landmark or registration reference, not a moving feature that should change. Approve only when the agreed registration is consistent and no cleanup warning remains unexplained.
If a deliberate manual offset is used instead, document that decision separately. It should not be reported as successful automatic hole recognition. Preserve the scans, cleanup settings and accepted level so another animator can reproduce the chosen route.
Related tasks
- Align Hugin Images Before Solving Panorama Exposure
- How Do I Take the Correct Scanned Page from a PDF for Image Editing?
- Why Does My Image Sequence Skip Frames or Play at the Wrong Speed?
Sources and scope
- OpenToonz1.7.1 official documentation: If pegbar holes are not recognized, cleanup reports an error yet continues applying other settings.
Based on the OpenToonz 1.7.1 published manual, including saved official full-body capture read on 2026-10-23. Later releases are not assumed equivalent. Examples and acceptance checks are proposed editorial procedures, not executed software tests. No measured query frequency or AI citation frequency.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: Paparazzi Ratzfatzzi / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.