Export to Harmony

Share your custom panels, brushes, papers... (you need to be registered to read posts in this section)
Post Reply
Cardin Collins
Posts: 67
Joined: 06 Sep 2010, 17:59

Export to Harmony

Post by Cardin Collins » 26 Jan 2021, 20:00

The purpose of these scripts is to help TVP users to continue using TVPaint even if their contract/commission work requires the deliverables to be done in TB Harmony. This process will allow you to import your TVPaint work to TB Harmony, keeping the layers and exposures intact.

There are two scripts, one for TVPaint, and the other for Harmony:

TVPAINT
EXPORT SCRIPT - When your work in TVP is done, simply click the export button on the panel. The TVP export script will export the TVP project as single folder containing a set of PNG's. The result will look like a JSON folder with each layer having a separate folder within the main folder.



HARMONY
IMPORT SCRIPT - This is a modified version of the Import script written by Jacob Kafka, the author of the Rough Animator software. There are instructions on how to install and run the script here: http://roughanimator.com/toharmony/. The steps there will work for the modified script.

In Harmony, run the TVP IMPORT Script and it will rebuild the project (layers and timing intact) and vectorize the lines.

**Depending on your needs, you may want additional control over how Harmony vectorizes your line work. This will add a few more steps to the process which I will try to explain.
First, you will want to use Harmony's standard import dialog menu to test the vectorization options until you get your desired results. You can then save these vectorization options and Harmony will create a text file containing the vectorization codes. Copy these codes and then Paste them into the TVP IMPORT script. So now when you run the TVP Import script, it will use the vectorization options that you tested earlier. It's a few extra steps but it's mostly just Copy & Paste.

Changing vectorization codes in the Import script :
Spoiler : :
Image


Image
DT Nethery very generously sacrificed his time to test the script and provide feedback as needed. With his help, I believe the EXPORT script runs pretty smoothly.
The IMPORT script that runs from Harmony could be improved but I have limited experience with Qt Script, the scripting language used by Harmony. It would be more convenient if the Import script would automatically open the Vectorization Dialog Window so that the user didn't have to open it up separately and then copy & paste the vectorization codes back into the script.

I'll update this post later with pictures to that the everything will be easier to follow

EXPORT Script
See attached file

IMPORT Script
https://drive.google.com/file/d/1SS9BVD ... sp=sharing
You do not have the required permissions to view the files attached to this post.
TVPaint PRO 11.0.8 (64bit)
1 - Desktop: Intel Core i7-3770K CPU 3.5GHz, GeForce GTX 750 Ti, 16 GB, Win 10
2 - Tablet/Laptop: Sony Vaio Flip15a - Intel Core i7 (4th Gen) 4500U / 1.8 GHz, NVIDIA GeForce GT 735M, 16 GB, Win 10

User avatar
D.T. Nethery
Posts: 3004
Joined: 27 Sep 2006, 19:19

Re: Export to Harmony

Post by D.T. Nethery » 27 Jan 2021, 16:43

Thanks for posting this , Cardin ! I had intended to do a video tutorial showing how to use this script, but I'm not currently working for the studio who provided me with the Harmony license (month-to-month license subscription) so I don't have a working license of Harmony at the moment. I'll probably wait to renew the license until I get another job using Harmony.
As far as adjusting the vectorization parameters , I can suggest spending some time in the Harmony user manual where it discusses how to adjust the vectorization parameters and do some tests, until you arrive at the ideal vectorization settings (take screen shots, take notes, write everything down). Most of the time if the original drawings from TVPaint are drawn with a clear, crisp line it will be a case of "what you see is what you get" , there won't be any noticeable difference in the line quality when it is vectorized in Harmony. With a very specific sort of texturized line quality you will need to tweak the parameters more carefully to retain the line quality.

Animator, TVPaint Beta-Tester, Animation Educator and Consultant.
MAC OS 10.14.6 , Macbook Pro Retina 15-inch, Late 2013,
2.3 GHz Intel Core i7, 16 GB Memory , TVPaint PRO 11.5.1 - 64bit ,
Wacom Cintiq 21 UX ,Wacom Intuos Pro 5 , Wacom driver version 6.3.39-1

User avatar
NathanOtano
Posts: 969
Joined: 01 Apr 2014, 07:07
Location: Paris, France
Contact:

Re: Export to Harmony

Post by NathanOtano » 03 Feb 2021, 16:59

Will be useful for lots of people! Thanks for the achievement :)
Nathan
Storyboard, animation and design work : http://nathanotano.tumblr.com/
As I'm highly interested in animation workflows, I'm open to scripting new TVP functions for individuals and studios. Please don't hesitate to contact me!

User avatar
D.T. Nethery
Posts: 3004
Joined: 27 Sep 2006, 19:19

Re: Export to Harmony

Post by D.T. Nethery » 12 Mar 2021, 14:42

Something I've discovered working more with Harmony is that many productions prefer the drawings (at least the final clean line drawings) to be drawn with the Pencil Tool , which is a different type of line than the Brush Tool in Harmony. (Pencil lines can be manipulated more easily in terms of adjusting the line width and texture than Brush strokes. Clean up with the Pencil tool is generally faster than using the Brush tool. ) .

However, Harmony's default mode when Importing and Vectorizing bitmap drawings is to vectorize them as Brush strokes, not as Pencil lines. In the Vectorization Parameter options you can enter a command to force it to vectorize as Pencil lines , but unfortunately this results in a vectorized pencil line quality that tends to be thicker and cruder than the original line quality and small gaps appear at points where the lines on a drawing intersect or overlap . Through trial and error testing I have been able to adjust the threshold and other settings on the vectorization parameters to somewhat improve the vectorized pencil line quality , but it is still not an acceptable line quality. I hope to be able to figure out the perfect vectorization parameters that will vectorize drawings as Harmony pencil lines , but so far this perfect setting eludes me.

This becomes a critical issue if you were working on a project where the final line artwork must be delivered in a Harmony file and your drawings made in TVPaint must match exactly the line quality of drawings made by other artists working directly in Harmony with the Pencil tool . (especially if they are using a textured Pencil line). I think it's possible to match the line quality so that drawings originally made in TVPaint and then vectorized in Harmony as Brush strokes will appear (to the naked eye) to be the same line quality as drawings made in Harmony using their Pencil tool , but it would be problem if the imported drawings needed to be adjusted using Harmony's Pencil LIne Editor , because if the lines are Brush strokes then you can not use the Pencil Editor. There is a tool in Harmony for "Convert Brush Strokes to Pencil Lines" , but in my experience it is worthless. It deforms the original drawing and all subtlety of the line quality is lost . (don't even go there , it doesn't work; not sure why they even keep it available as an option)

If all you need to do is vectorize drawings originally made in TVPaint into Harmony so they can be colored , then vectorizing the drawings as Brush strokes works fine. The line quality of the original drawing is retained when it is vectorized in Harmony as a Brush stroke. The problem will be if your drawings must be delivered in the Harmony file as Pencil lines instead of Brush strokes. It may be that I'm still such a newbie using Harmony that I haven't figured out how to do it properly with the correct vectorization parameters to import and vectorize the drawings as Pencil lines with acceptable line quality, but I noticed that the only response I received to my query on the Harmony forum was : "I don't think there's anything you can do about that" . (meaning the blocky line quality and the gaps that appear where lines touch).

Animator, TVPaint Beta-Tester, Animation Educator and Consultant.
MAC OS 10.14.6 , Macbook Pro Retina 15-inch, Late 2013,
2.3 GHz Intel Core i7, 16 GB Memory , TVPaint PRO 11.5.1 - 64bit ,
Wacom Cintiq 21 UX ,Wacom Intuos Pro 5 , Wacom driver version 6.3.39-1

User avatar
Soom
Posts: 870
Joined: 25 Jul 2011, 16:25
Location: World
Contact:

Re: Export to Harmony

Post by Soom » 02 Apr 2021, 21:55

Amazing! wow - I think my workflow options have just expanded enormously and now every time I catch myself on cursing at Toon Boom more than 24 times per second, I can always switch to TVP. thank you for this script!
Hackintosh, OS 10.13.6, Cintiq 22", TVP Pro 11.5.1, http://danasb.com

Post Reply